PHP-PM 使用教程

PHP-PM 使用教程

php-pmPPM is a process manager, supercharger and load balancer for modern PHP applications.项目地址:https://gitcode.com/gh_mirrors/ph/php-pm

1. 项目目录结构及介绍

PHP-PM 的目录结构如下：

.
├── bin          # 包含命令行工具
│   └── ppm       # 主要的PHP-PM控制台命令
├── src          # 主体代码库
├── tests        # 单元测试和集成测试
├── editorconfig  # 编辑器配置文件
├── gitattributes # Git属性配置
├── gitignore     # Git忽略文件列表
├── php_cs        # PHP编码标准配置
├── LICENSE      # 许可证文件
└── README.md    # 项目读我文件

• bin/ppm 是主要的控制台脚本，用于启动和管理PHP-PM进程。
• src 存放核心源代码。
• tests 包含项目的测试用例。
• 其他文件如 editorconfig, gitattributes, gitignore, php_cs 用来维护开发环境的一致性和代码质量。

2. 项目的启动文件介绍

PHP-PM 启动文件通常是 bin/ppm 脚本。你可以通过以下命令在终端中运行它来启动服务：

$ ./bin/ppm start

该命令会依据默认配置启动PHP-PM，监听指定端口并准备好接收HTTP请求。ppm 命令还支持其他操作，例如停止（stop）、重启（restart）和查看状态（status）等。

可以通过ppm start --help查看更多参数选项：

Usage:
  ppm start [options]

Options:
  -p, --port[=PORT]            Port number to listen on (default: 8080)
  -b, --bootstrap=BOOTSTRAP    Absolute path to the application bootstrap script
  -c, --configuration=CONFIG   Configuration file in YAML format
  --help                       Display this help message
  --version                    Show the version and exit

3. 项目的配置文件介绍

PHP-PM 可以通过配置文件自定义其行为。配置文件采用 YAML 格式，默认情况下不需要，但可以使用 -c 或 --configuration 参数指定。以下是配置文件可能包含的一些关键设置示例：

http:
  port: 8080
  bind: 127.0.0.1

processManager:
  restartTimeout: 3000
  maxChildren: 5
  maxRequests: 1000

application:
  preload: 
    - "vendor/autoload.php"
  bootstrap: "./public/index.php"

logging:
  level: info
  file: /path/to/logfile.log

• http.port 和 http.bind 分别指定了监听的端口号和IP地址。
• processManager.restartTimeout, maxChildren 和 maxRequests 管理了子进程的行为，如多久后强制重启、最大并发进程数以及单个进程处理的最大请求数量。
• application.preload 列出了在所有工作进程中预加载的文件，通常包括自动加载器。
• application.bootstrap 指定应用的入口点，即处理HTTP请求的PHP脚本。
• logging 部分定义了日志级别和文件位置。

要使用配置文件启动PHP-PM，可以执行如下命令：

$ ./bin/ppm start -c path/to/config.yml

请注意，实际的配置文件路径需替换为你的本地路径。

php-pmPPM is a process manager, supercharger and load balancer for modern PHP applications.项目地址:https://gitcode.com/gh_mirrors/ph/php-pm