Installation & Configuration

首先安装依赖。

composer require hyperf/gotask

如果是非Hyperf用户，可以跳过本节余下内容，直接进入使用说明。

Hyperf用户请继续执行。

php bin/hyperf.php vendor:publish hyperf/gotask

在config/autoload/gotask.php打开配置文件，可以看到如下内容：

return [
    'enable' => true,
    'executable' => BASE_PATH . '/bin/app',
    'socket_address' => \Hyperf\GoTask\ConfigProvider::address(),
    'go2php' => [
        'enable' => true,
        'address' => \Hyperf\GoTask\ConfigProvider::address(),
    ],
    'go_build' => [
        'enable' => true,
        'workdir' => BASE_PATH . '/gotask',
        'command' => 'go build -o ../bin/app cmd/app.go',
    ],
    'pool' => [
        'min_connections' => 1,
        'max_connections' => 30,
        'connect_timeout' => 10.0,
        'wait_timeout' => 30.0,
        'heartbeat' => -1,
        'max_idle_time' => (float) env('GOTASK_MAX_IDLE_TIME', 60),
    ],
];

• enable: 边车模式是否自动启动。
• executable: go编译完毕的二进制文件路径。
• socket_address: Unix Socket地址，一般随便编写一个有权限的路径即可。默认配置也是根据项目名称随机生成。也可以填写TCP地址，如127.0.0.1:6001。
• pool: Hyperf的连接池参数。
• 其他几项在文档中再做详细讲解。

如无特殊需要，默认配置无需修改。

在项目根目录会生成一个gotask文件夹，内含一个cmd/app.go文件和一个go.sum的文件。该文件夹可以作为go工程使用。

进入gotask文件夹，可以直接编译并安装go方面的依赖。

cd gotask
go build -o ../bin/app cmd/app.go

按照最佳实践，我们将编译好的app放到Hyperf项目bin目录下。