MixPHP V3
发布后,由于本身支持超多的执行模式,用户可能无从下手,这里先大体介绍一下:
- CLI-Server: 适合本机开发,零扩展依赖,Windows/MacOS 等全平台支持
- PHP-FPM: 适合共享开发环境部署,同时适合 admin 等管理后台项目
- Swoole, Workerman: 适合线上部署,根据需要选择其一即可
Swoole 的多种模式:
- Swoole 多进程同步: 适合需要使用那些协程不支持的第三方库的项目,和 Workerman 一致
- Swoole 多进程协程: 适合专注 mysql + redis 需要超高 io 性能的项目
- Swoole 单进程协程: 单进程协程就是
V2.2
版本那种 golang 风格协程,适合开发 websocket
几乎支持 PHP 流行的全部执行模式,并且以上执行模式代码是无缝切换的,真正做到效率与性能并存。
请帮忙 Star 一下:
- https://github.com/mix-php/mix
- https://gitee.com/mix-php/mix
首先创建一个骨架
我们以开发一个 API 项目为例,打开 MixPHP 的 开发文档 里面有 cli
api
web
websocket
grpc
项目的开发教程,V3
开始仓库底下的 README
就是开发文档,如果有不明白的可以加我们的 官方QQ群 参与讨论。
- 首先创建一个骨架
如果提示缺少 redis
等扩展支持,可以使用 --ignore-platform-reqs
暂时忽略依赖检查
composer create-project --prefer-dist --ignore-platform-reqs mix/api-skeleton api
安装后目录结构如下:
-
bin
目录是全部入口文件,不同文件对应的不同驱动模式 -
routes
是路由配置文件 -
public/index.php
是 FPM, CLI-Server 两种模式的入口文件 -
shell/server.sh
是部署是管理进程start|stop|restart
├── README.md
├── bin
│ ├── cli.php
│ ├── swoole.php
│ ├── swooleco.php
│ └── workerman.php
├── composer.json
├── composer.lock
├── conf
│ └── config.json
├── public
│ └── index.php
├── routes
│ └── index.php
├── runtime
├── shell
│ └── server.sh
├── src
│ ├── Command
│ ├── Container
│ ├── Controller
│ ├── Error.php
│ ├── Middleware
│ ├── Vega.php
│ └── functions.php
└── vendor
使用 CLI-Server 零扩展依赖模式本机开发
首先我们查看一下 composer.json
,与其他框架不同的是我们推荐在本机开发阶段使用 composer run-script
启动程序,可以和 PhpStorm
的调试功能完美配合。
- 这里定义了每个执行模式的命令入口文件
-
composer run-script --timeout=0 cliserver:start
就可以启动命令
"scripts": {
"cliserver:start": "php -S localhost:8000 public/index.php",
"swoole:start": "php bin/swoole.php",
"swooleco:start": "php bin/swooleco.php",
"workerman:start": "php bin/workerman.php start",
"cli:clearcache": "php bin/cli.php clearcache"
}
由于现在是本机开发,我们使用 CLI-Server 模式启动,零扩展依赖,无需 pcntl
, event
, swoole
这些扩展,自带热更新。
% composer run-script --timeout=0 cliserver:start
> php -S localhost:8000 public/index.php
PHP 7.3.24-(to be removed in future macOS) Development Server started at Tue Aug 10 17:00:55 2021
Listening on http://localhost:8000
Document root is /Users/***/mix/examples/api-skeleton
Press Ctrl-C to quit.
测试一下默认的路由
% curl http://127.0.0.1:8000/hello
hello, world!
接下来就可以根据文档:
- 编写一个 API 接口
使用 PHP-FPM 部署共享开发环境
热更新是刚性需求,所以共享开发环境我们直接采用 PHP-FPM 部署,和 Laravel、ThinkPHP 部署方法完全一致,将 public/index.php
在 nginx
配置 rewrite
重写即可。
server {
server_name www.domain.com;
listen 80;
root /data/project/public;
index index.html index.php;
location / {
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php/$1 last;
}
}
location ~ ^(.+\.php)(.*)$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_split_path_info ^(.+\.php)(.*)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
使用 Swoole 多进程协程模式线上部署
Swoole、Workerman 你可以随意选择,这里我们采用 Swoole 举例。
- 首先安装 Swoole 扩展
- 修改
shell/server.sh
脚本中的绝对路径和参数
这里我们选择的 Swoole 多进程协程模式,因此入口文件为 bin/swoole.php
,其他模式参考 composer.json
php=/usr/local/bin/php
file=/data/project/bin/swoole.php
cmd=start
numprocs=1
启动管理
sh /data/project/shell/server.sh start
sh /data/project/shell/server.sh stop
sh /data/project/shell/server.sh restart
接下来将启动命令加入 crontab
防止程序异常中断
*/1 * * * * sh /data/project/shell/server.sh start > /tmp/server.sh.log 2>&1 &
当修改代码时,使用 restart
让代码生效
sh /data/project/shell/server.sh restart