Surfer 项目使用教程

1. 项目的目录结构及介绍

Surfer 项目的目录结构如下：

surfer/
├── example/
├── vendor/
├── .gitignore
├── LICENSE
├── README.md
├── README_ZH.md
├── agent.go
├── agent_bsd.go
├── agent_linux.go
├── agent_linux_arm.go
├── agent_windows.go
├── body.go
├── go.mod
├── go.sum
├── phantom.go
├── request.go
├── surf.go
├── surfer.go
├── surfer_test.go
└── util.go

目录结构介绍

• example/: 包含项目的示例代码。
• vendor/: 存放项目的依赖包。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的英文介绍文档。
• README_ZH.md: 项目的中文介绍文档。
• agent.go, agent_bsd.go, agent_linux.go, agent_linux_arm.go, agent_windows.go: 不同操作系统下的代理实现。
• body.go: HTTP 请求体相关实现。
• go.mod, go.sum: Go 模块管理文件。
• phantom.go: PhantomJS 引擎相关实现。
• request.go: HTTP 请求相关实现。
• surf.go: Surf 引擎相关实现。
• surfer.go: 主文件，包含 Surfer 的核心功能。
• surfer_test.go: 测试文件。
• util.go: 工具函数实现。

2. 项目的启动文件介绍

Surfer 项目的启动文件是 surfer.go。该文件包含了 Surfer 的核心功能，包括 HTTP 客户端的初始化、请求处理、以及不同下载引擎（如 Surf 和 PhantomJS）的调用。

主要功能

• HTTP 客户端初始化: 初始化 Surfer 客户端，设置请求头、Cookie 等。
• 请求处理: 处理 HTTP 请求，支持 GET、POST 等方法。
• 下载引擎: 支持 Surf 和 PhantomJS 两种下载引擎，模拟浏览器行为。

3. 项目的配置文件介绍

Surfer 项目没有明确的配置文件，但可以通过代码中的配置函数进行设置。例如，可以通过 surfer.SetPhantomJsFilePath 设置 PhantomJS 引擎的路径。

主要配置函数

• surfer.SetPhantomJsFilePath(path string): 设置 PhantomJS 引擎的路径。
• surfer.Download(request *surfer.Request): 发起 HTTP 请求，返回响应。

示例代码

package main

import (
    "github.com/andeya/surfer"
    "io/ioutil"
    "log"
)

func main() {
    // 使用 Surf 引擎
    resp, err := surfer.Download(&surfer.Request{
        Url: "http://github.com/andeya/surfer",
    })
    if err != nil {
        log.Fatal(err)
    }
    b, err := ioutil.ReadAll(resp.Body)
    log.Println(string(b), err)

    // 使用 PhantomJS 引擎
    surfer.SetPhantomJsFilePath("Path to phantomjs.exe")
    resp, err = surfer.Download(&surfer.Request{
        Url: "http://github.com/andeya",
        DownloaderID: 1,
    })
    if err != nil {
        log.Fatal(err)
    }
    b, err = ioutil.ReadAll(resp.Body)
    log.Println(string(b), err)
    resp.Body.Close()
    surfer.DestroyJsFiles()
}

通过上述代码，可以配置并使用 Surfer 项目进行 HTTP 请求。