使用 systemd 设置 PHP 程序为服务

使用 systemd 设置 PHP 程序为服务

在现代 Linux 系统中，systemd 是用于管理和控制服务的标准工具。通过 systemd，我们可以轻松地将 PHP 程序配置为后台运行的系统服务，从而实现自动化启动、重启和日志记录等功能。本文将介绍如何为 PHP 程序设置 systemd 服务单元，并涵盖相关配置步骤。

背景

假设我们有一个基于 PHP 的 Web 应用或脚本，需要在后台运行并且能够自动重启。通过配置 systemd，我们可以轻松实现以下目标：

• 启动时自动加载 PHP 应用。
• 在应用崩溃时自动重启。
• 设置日志记录路径，以便查看服务运行状态。
• 为服务指定特定的运行用户与组权限。

接下来，我们将一步步演示如何为一个 PHP 程序创建 systemd 服务。

步骤 1: 创建服务单元文件

服务单元文件是 systemd 管理服务的核心。首先，我们需要在 /etc/systemd/system/ 目录下为 PHP 程序创建一个新的 .service 文件。

sudo nano /etc/systemd/system/myapp.service

该文件的命名通常采用 <服务名>.service 的格式，比如这里使用 myapp.service。

步骤 2: 编写服务单元文件

在创建的文件中，填写如下内容来定义服务的行为：

[Unit]
Description=My PHP Application
After=network.target

[Service]
ExecStart=/usr/bin/php /var/www/html/myapp/index.php
Restart=always
User=www-data
Group=www-data
Environment=APP_ENV=production
WorkingDirectory=/var/www/html/myapp
StandardOutput=append:/var/log/myapp/output.log
StandardError=append:/var/log/myapp/error.log

[Install]
WantedBy=multi-user.target

关键配置说明：

• [Unit] 部分:

  • Description：对服务的简短描述，方便管理员了解服务用途。
  • After=network.target：指定服务在网络服务启动后才运行，适合需要网络的应用。

• [Service] 部分:

  • ExecStart：定义服务启动时执行的命令。在此，我们指定了使用 PHP CLI 来运行 /var/www/html/myapp/index.php 文件。
  • Restart=always：确保服务崩溃时自动重启，以保证持续运行。
  • User 和 Group：指定运行该服务的用户和组。这里使用了 www-data，它是大多数 Web 服务器（如 Apache 和 Nginx）使用的默认用户。
  • Environment=APP_ENV=production：设置环境变量，比如指定应用程序的运行环境为 production。
  • WorkingDirectory：指定 PHP 程序的工作目录，这有助于确保程序正确地找到相关文件。
  • StandardOutput 和 StandardError：指定标准输出和错误日志的存储路径。我们将日志输出到 /var/log/myapp/ 目录下，分别记录标准输出和错误信息。

• [Install] 部分:

  • WantedBy=multi-user.target：表示该服务适用于多用户模式。

步骤 3: 创建日志目录

确保日志目录存在且具有适当的权限。你可以通过以下命令创建日志目录并设置权限：

sudo mkdir -p /var/log/myapp
sudo chown www-data:www-data /var/log/myapp

这将创建 /var/log/myapp/ 目录并将其所有权授予 www-data 用户和组。

步骤 4: 重新加载 systemd 并启动服务

配置完服务单元文件后，需要重新加载 systemd 配置，并启动服务：

sudo systemctl daemon-reload
sudo systemctl start myapp.service

如果你希望服务在系统启动时自动运行，可以启用它：

sudo systemctl enable myapp.service

步骤 5: 检查服务状态

为了确认服务是否已正确启动，可以使用以下命令查看服务的状态：

systemctl status myapp.service

你将看到关于服务是否正常运行、最后一次启动的时间以及输出日志等信息。

步骤 6: 查看服务日志

根据前面定义的日志配置，PHP 程序的输出和错误信息会记录到 /var/log/myapp/output.log 和 /var/log/myapp/error.log 中。可以通过以下命令查看日志内容：

cat /var/log/myapp/output.log
cat /var/log/myapp/error.log

另外，你也可以使用 journalctl 命令来查看 systemd 日志：

journalctl -u myapp.service

总结

通过上述步骤，我们成功地将一个 PHP 程序配置为 systemd 服务，使其能够自动启动、崩溃时自动重启，并记录日志文件。通过这种方式，管理员可以轻松管理后台运行的 PHP 应用程序，确保其稳定性和可维护性。

关键命令汇总

• 启动服务：sudo systemctl start myapp.service
• 停止服务：sudo systemctl stop myapp.service
• 重启服务：sudo systemctl restart myapp.service
• 启用开机自启：sudo systemctl enable myapp.service
• 禁用开机自启：sudo systemctl disable myapp.service
• 查看服务状态：systemctl status myapp.service
• 重新加载服务单元文件：sudo systemctl daemon-reload

通过合理配置和使用 systemd，你可以极大提升 PHP 应用的管理效率和稳定性。