phpenv 不能被 systemd 管理，需手动为 php8.4.1 创建 systemd service 文件，前提是编译时启用 --with-fpm-systemd，再配置 Type=notify、正确路径与用户权限。
phpenv 本身不提供 systemd 集成，它只是一个 PHP 版本切换工具（类似 rbenv），用于在 shell 环境中切换 php 命令的二进制路径，不负责启动或管理 PHP-FPM 服务。所以“让 phpenv 启动的 PHP 8.4.1 被 systemd 管理”这个说法存在概念混淆——systemd 管理的是系统级服务（如 php8.4-fpm 进程），不是 phpenv 的 shell 环境。
真正需要做的是：用 phpenv 安装好 PHP 8.4.1 后，手动为它创建一个符合 systemd 规范的 .service 文件，并确保 PHP 编译时启用了 FPM + systemd 支持。
确认 PHP 8.4.1 是以 --enable-fpm 和 --with-fpm-systemd 编译的
phpenv 默认安装不启用 --with-fpm-systemd，而这是 Type=notify 正常工作的前提。检查方法：
/usr/local/phpenv/versions/8.4.1/sbin/php-fpm -v 2>&1 | grep -i systemd
若无输出，说明未编译支持。此时需重新编译：
立即学习“PHP免费学习笔记（深入）”；
Yuanfang Design System
下载
yuanfang-skills 的共享设计系统，提供 token CSS 变量、12+ 主题以及可复用的布局类型 HTML 块，供 yuanfang-html-image（以及 fu...）使用。
cd ~/.phpenv/sources/8.4.1 ./configure \ --enable-fpm \ --with-fpm-systemd \ --with-fpm-user=www \ --with-fpm-group=www \ --prefix=$HOME/.phpenv/versions/8.4.1 \ --with-openssl \ --enable-opcache \ # 其他你需要的扩展... make && make install
✅ 关键点：必须含
--with-fpm-systemd，否则无法使用Type=notify，后续会掉坑。
创建 systemd service 文件（推荐放 /etc/systemd/system/）
新建文件 /etc/systemd/system/php8.4-fpm.service：
[Unit] Description=PHP 8.4.1 FastCGI Process Manager After=network.target [Service] Type=notify User=www Group=www PIDFile=/home/youruser/.phpenv/versions/8.4.1/var/run/php-fpm.pid ExecStart=/home/youruser/.phpenv/versions/8.4.1/sbin/php-fpm \ --nodaemonize \ --fpm-config /home/youruser/.phpenv/versions/8.4.1/etc/php-fpm.conf ExecReload=/bin/kill -USR2 $MAINPID Restart=always RestartSec=3 [Install] WantedBy=multi-user.target
⚠️ 注意替换：
-
youruser→ 实际用户名（不要用$HOME，systemd 不展开） - 路径需与 phpenv 实际安装路径一致（默认是
~/.phpenv/versions/8.4.1/） -
php-fpm.conf必须存在且配置了pid = /.../php-fpm.pid和user/group = www
启用并验证服务
# 重载配置 sudo systemctl daemon-reload # 启用开机自启（可选） sudo systemctl enable php8.4-fpm # 启动服务 sudo systemctl start php8.4-fpm # 检查状态（重点看 active (running) 和 no errors） sudo systemctl status php8.4-fpm # 查看日志（如有报错，这里最直观） sudo journalctl -u php8.4-fpm -n 50 -f
常见失败原因：
- PID 文件路径不匹配（
php-fpm.conf中pid设置 vs service 文件中PIDFile） -
www用户不存在 →sudo useradd -r -s /bin/false www - 权限问题 → 确保
/home/youruser/.phpenv/versions/8.4.1/var/run/所属用户为www - SELinux 或 AppArmor 拦截（RHEL/CentOS/Ubuntu 可能需临时 setenforce 0 测试）
不建议混用 phpenv 和系统级服务管理
- phpenv 的设计目标是开发环境多版本共存，不是生产服务托管；
- 生产环境更推荐用包管理器（如 Ubuntu 的 PPA）或源码编译后直接安装到
/usr/local/php8.4，再配 systemd； - 若坚持用 phpenv，务必把所有路径写死、避免依赖
$HOME或 shell 函数，因为 systemd 不读你的.bashrc。
不复杂但容易忽略。
