官方文档
* https://hyperf.wiki/2.0/#/README

初步搭建
1. 安装项目

composer create-project hyperf/hyperf-skeleton

2. 项目根目录配置为当前目录的安装目录根目录，即不存在public目录

3. 配置Nginx反向代理

# 至少需要一个 Hyperf 节点，多个配置多行
upstream hyperf {

Hyperf HTTP Server 的 IP 及 端口

server 127.0.0.1:9501;
server 127.0.0.1:9502;
}

server {

监听端口

listen 80;

绑定的域名，填写您的域名

server_name proxy.hyperf.io;

location / {

将客户端的 Host 和 IP 信息一并转发到对应节点

proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

转发Cookie，设置 SameSite

proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

执行代理访问真实服务器

proxy_pass http://hyperf;
}
}

4. 宝塔Nginx配置为（同LNMP的Nginx配置）

upstream hyperf {

Hyperf HTTP Server 的 IP 及 端口

server 127.0.0.1:9501;
server 127.0.0.1:9502;
}

server
{
listen 80;
server_name hyperf.com.net;
index index.php index.html index.htm default.php default.htm default.html;
root /www/wwwroot/hyperf-skeleton;

#SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
#error_page 404/404.html;
#SSL-END

#ERROR-PAGE-START 错误页配置，可以注释、删除或修改
#error_page 404 /404.html;
#error_page 502 /502.html;
#ERROR-PAGE-END

#PHP-INFO-START PHP引用配置，可以注释或修改
include enable-php-74.conf;
#PHP-INFO-END

location / {

将客户端的 Host 和 IP 信息一并转发到对应节点

proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

转发Cookie，设置 SameSite

proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

执行代理访问真实服务器

proxy_pass http://hyperf;
}

#REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
include /www/server/panel/vhost/rewrite/hyperf.kefu.com.net.conf;
#REWRITE-END

#禁止访问的文件或目录
location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)
{
return 404;
}

#一键申请SSL证书验证目录相关设置
location ~ \.well-known{
allow all;
}

location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
expires 30d;
error_log off;
access_log /dev/null;
}

location ~ .*\.(js|css)?$
{
expires 12h;
error_log off;
access_log /dev/null;
}
access_log /www/wwwlogs/hyperf.kefu.com.net.log;
error_log /www/wwwlogs/hyperf.kefu.com.net.error.log;
}

5.启动http服务命令

php bin/hyperf.php start

或者重写启动文件watch。执行命令为：php watch

#!/usr/bin/env php
<?php

/**
* Hyperf Watch Hot Reload Scripts
* From: https://github.com/ha-ni-cc/hyperf-watch
* Author: hanicc@qq.com
* Usage:
* Open the terminal console in the project root directory and enter：php watch
* 在项目根目录下打开终端控制台，输入：php watch
* If you want to clean the /runtime/container cache, enter: php watch -c
* 如果你想要清除/runtime/container缓存，则输入：php watch -c
*/

PHP Bin File PHP程序所在路径（默认自动获取）

const PHP_BIN_FILE = 'which php';

Watch Dir 监听目录（默认监听脚本所在的根目录）

const WATCH_DIR = __DIR__ . '/';

Watch Ext 监听扩展名（多个可用英文逗号隔开）

const WATCH_EXT = 'php,env';

Exclude Dir 排除目录（不监听的目录，数组形式)

const EXCLUDE_DIR = ['vendor', 'runtime', 'public'];

Entry Point File 入口文件

const ENTRY_POINT_FILE = __DIR__ . '/bin/hyperf.php';

Start Command 启动命令

const START_COMMAND = [ENTRY_POINT_FILE, 'start'];

PID File Path PID文件路径

const PID_FILE_PATH = __DIR__ . '/runtime/hyperf.pid';

Scan Interval 扫描间隔（毫秒，默认2000）

const SCAN_INTERVAL = 2000;

if (!function_exists('exec')) {
echo '[x] 请在php.ini配置中取消禁用exec方法' . PHP_EOL;
exit(1);
}

define('PHP', PHP_BIN_FILE == 'which php' ? exec('which php') : PHP_BIN_FILE);

if (!file_exists(PHP) || !is_executable(PHP)) {
echo '[x] PHP bin (" ' . PHP . ' ") 路径没有找到或无法执行，请确认路径正确?' . PHP_EOL;
exit(1);
}

if (!file_exists(ENTRY_POINT_FILE)) {
echo '[x] 入口文件 ("' . ENTRY_POINT_FILE . '") 没有找到，请确认文件存在?' . PHP_EOL;
exit(1);
}

加载env

$content = @file_get_contents('.env');
$values = array_filter(preg_split("/(\r\n|\n|\r)/", $content));
foreach ($values as $val) {
if (substr($val, 0, 1) === '#') {
continue;
}
list($name, $value) = explode('=', $val);
$_ENV[$name] = $value;
}

use Swoole\Process;
use Swoole\Timer;
use Swoole\Event;

swoole_async_set(['enable_coroutine' => false, 'log_level' => SWOOLE_LOG_INFO]);
$hashes = [];
$serve = null;
echo " Start @ " . date('Y-m-d H:i:s') . PHP_EOL;
start();
state();
Timer::tick(SCAN_INTERVAL, 'watch');

function killOldProcess()
{
// pid存在则关闭存在的进程
if (file_exists(PID_FILE_PATH) && $pid = @file_get_contents(PID_FILE_PATH)) {
if (!@posix_kill($pid)) forceKill();
} else forceKill();
}

function forceKill($match = '')
{
if (!$match) {
$match = @$_ENV['APP_NAME'] . '.Master';
}
// 适配MacOS
if (PHP_OS == 'Darwin') $match = ENTRY_POINT_FILE;
$command = "ps -ef | grep '$match' | grep -v grep | awk '{print $2}' | xargs kill -9 2>&1";
// 找不到pid，强杀进程
exec($command);
}

function start()
{
// 杀旧进程
killOldProcess();
global $serve;
$serve = new Process('serve', true);
$serve->start();
if (false === $serve->pid) {
echo swoole_strerror(swoole_errno()) . PHP_EOL;
exit(1);
}
addEvent($serve);
}

function addEvent($serve)
{
Event::add($serve->pipe, function () use (&$serve) {
$message = @$serve->read();
if (!empty($message)) {
echo $message;
}
});
}

function watch()
{
global $hashes;
foreach ($hashes as $pathName => $currentHash) {
if (!file_exists($pathName)) {
unset($hashes[$pathName]);
continue;
}
$newHash = fileHash($pathName);
if ($newHash != $currentHash) {
change();
state();
break;
}
}
}

function state()
{
global $hashes;
$files = phpFiles(WATCH_DIR);
$hashes = array_combine($files, array_map('fileHash', $files));
$count = count($hashes);
echo " Watching $count files…" . PHP_EOL;
}

function change()
{
global $serve;
echo " Restart @ " . date('Y-m-d H:i:s') . PHP_EOL;
Process::kill($serve->pid);
start();
}

function serve(Process $serve)
{
$opt = getopt('c');

if (isset($opt['c'])) echo exec(PHP . ' ' . ENTRY_POINT_FILE . ' di:init-proxy') . '..' . PHP_EOL;

if (isset($opt['c'])) delDir('./runtime/container');
$serve->exec(PHP, START_COMMAND);
}

function fileHash(string $pathname): string
{
$contents = @file_get_contents($pathname);
if (false === $contents) {
return 'deleted';
}
return md5($contents);
}

function phpFiles(string $dirname): array
{
$directory = new RecursiveDirectoryIterator($dirname);
$filter = new Filter($directory);
$iterator = new RecursiveIteratorIterator($filter);
return array_map(function ($fileInfo) {
return $fileInfo->getPathname();
}, iterator_to_array($iterator));
}

function delDir($path)
{
if (is_dir($path)) {
//扫描一个目录内的所有目录和文件并返回数组
$dirs = scandir($path);
foreach ($dirs as $dir) {
//排除目录中的当前目录(.)和上一级目录(..)
if ($dir != '.' && $dir != '..') {
//如果是目录则递归子目录，继续操作
$sonDir = $path . '/' . $dir;
if (is_dir($sonDir)) {
//递归删除
delDir($sonDir);
//目录内的子目录和文件删除后删除空目录
@rmdir($sonDir);
} else {
//如果是文件直接删除
@unlink($sonDir);
}
}
}
@rmdir($path);
}
}

class Filter extends RecursiveFilterIterator
{
public function accept()
{
if ($this->current()->isDir()) {
if (preg_match('/^\./', $this->current()->getFilename())) {
return false;
}
return !in_array($this->current()->getFilename(), EXCLUDE_DIR);
}
$list = array_map(function (string $item): string {
return "\.$item";
}, explode(',', WATCH_EXT));
$list = implode('|', $list);
return preg_match("/($list)$/", $this->current()->getFilename());
}
}

6. 启动报错

ERROR Swoole short name have to disable before start server, please set swoole.use_shortname = off into your php.ini.

php.ini文件最后一行新增 swoole.use_shortname = off 即可

7. 访问当前配置域名返回