README

帮助你快速搭建API项目骨架，并指导你如何使用该骨架的细节。骨架默认开启了SQL、Redis日志，压测前请先关闭.env中的APP_DEBUG。

安装

需要先安装Swoole或者WorkerMan。

composer create-project --prefer-dist mix/api-skeleton api

快速开始

启动cli-server开发服务（零依赖）。

composer run-script --timeout=0 cliserver:start

启动Swoole多进程服务

composer run-script --timeout=0 swoole:start

启动Swoole协程服务

composer run-script --timeout=0 swooleco:start

启动Swow协程服务

需自行安装composer require swow/swow:develop。注意：swow不支持PHP 8.0以下版本。

composer run-script --timeout=0 swow:start

启动WorkerMan多进程服务

composer run-script --timeout=0 workerman:start

执行脚本

composer run-script命令中的--timeout=0参数是防止composer执行超时。
composer.json定义了命令执行脚本，对应上面的执行命令。

"scripts": {
    "cliserver:start": "php -S localhost:8000 public/index.php",
    "swoole:start": "php bin/swoole.php",
    "swooleco:start": "php bin/swooleco.php",
    "swow:start": "php bin/swow.php",
    "workerman:start": "php bin/workerman.php start",
    "cli:clearcache": "php bin/cli.php clearcache"
}

当然也可以直接下面这样启动，效果是一样的，但是scripts能帮你记录到底有哪些可用的命令，同时在IDE中调试更加方便。

php bin/swoole.php start

编写一个API接口

首先修改根目录.env文件的数据库信息

然后在routes/index.php定义一个新的路由

$vega->handle('/users/{id}', [new Users(), 'index'])->methods('GET');

路由里使用了Users控制器，我们需要创建它

如何配置路由：mix/vega
如何调用数据库：mix/database

<?php

namespace App\Controller;

use App\Container\DB;
use Mix\Vega\Context;

class Users
{

    /**
     * @param Context $ctx
     * @throws \Exception
     */
    public function index(Context $ctx)
    {
        $row = DB::instance()->table('users')->where('id = ?', $ctx->param('id'))->first();
        if (!$row) {
            throw new \Exception('User not found');
        }
        $ctx->JSON(200, [
            'code' => 0,
            'message' => 'ok',
            'data' => $row
        ]);
    }

}

重新启动服务器后方可测试新开发的接口

实际开发中使用PhpStorm的Run功能，只需要点击一下重启按钮即可

// 查找进程 PID
ps -ef | grep swoole

// 通过 PID 停止进程
kill PID

// 重新启动进程
composer run-script swoole:start

// curl 测试
curl http://127.0.0.1:9501/users/1

使用容器中的对象

容器采用了一个简单的单例模式，你可以修改为更加适合自己的方式。

数据库：mix/database

DB::instance()

Redis：mix/redis

RDS::instance()

日志：monolog/monolog

Logger::instance()

配置：hassankhan/config

Config::instance()

部署

线上部署启动时，修改shell/server.sh脚本中的绝对路径和参数

php=/usr/local/bin/php
file=/project/bin/swoole.php
cmd=start
numprocs=1

启动管理

sh shell/server.sh start
sh shell/server.sh stop
sh shell/server.sh restart

使用nginx或者SLB代理到服务器端口即可

server {
    server_name www.domain.com;
    listen 80;

    location / {
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header Host $http_host;
        proxy_set_header Scheme $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        if (!-f $request_filename) {
             proxy_pass http://127.0.0.1:9501;
        }
    }
}

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;
    }
}

许可协议

Apache License Version 2.0, https://apache.ac.cn/licenses/

mix / api-skeleton

维护者

详细信息