Debian PHP运行环境要求

Debian PHP运行环境要求与选型建议

一 系统版本与PHP版本选择

• 选择与系统版本匹配的PHP主版本，优先使用系统仓库的默认版本，兼顾稳定性与安全性。
• 如需更新或更多版本，可通过 Debian 12 的默认 PHP 8.2 或使用 SURY 存储库安装 PHP 8.3 等新版。
• 选择依据建议：稳定性、兼容性（框架/扩展依赖）、安全性（补丁周期）、性能、长期支持（LTS）、资源占用与社区支持；如需在同一台机器运行多版本，可使用多版本共存方案（update-alternatives 或容器化）。

二 组件与扩展要求

• Web 服务器
  • Apache：安装 libapache2-mod-php 模块与 PHP 核心包。
  • Nginx：安装 php-fpm，并通过 FastCGI 代理到 PHP-FPM（常见为 Unix 套接字）。
• 语言与核心组件
  • PHP-FPM（进程管理、并发与资源隔离）、PHP-CLI（命令行/部署/脚本）、OPcache（字节码缓存，生产强烈建议启用）。
• 常用扩展（按应用选择）
  • 基础与数据处理：mbstring、xml、json、zip、bcmath、curl。
  • 数据库：php-mysql（或 php-mysqlnd）用于 MySQL/MariaDB；如需 PostgreSQL 则安装 php-pgsql。
  • 图像与多媒体：gd（常需系统库如 libjpeg-dev、libpng-dev、libfreetype6-dev 支持）。
  • 加密与系统：openssl、sodium、argon2（按需）。
• 典型安装示例（命令）
  • apt 安装核心与常用扩展：sudo apt install php php-cli php-mbstring php-xml php-common php-curl php-mysql php-gd php-zip php-opcache
  • Apache：sudo apt install apache2 libapache2-mod-php
  • Nginx + PHP-FPM：sudo apt install nginx php-fpm
• 说明
  • 扩展包名在不同 Debian 版本可能略有差异，安装时请以 apt 搜索结果为准（如 php8.2-mysql、php8.3-gd 等）。

三 部署与运行配置要点

• 目录与权限
  • Web 根目录常用 /var/www/html；确保运行用户（如 www-data）对目录与文件具备合适的读写/执行权限。
• 服务与进程管理
  • Web 服务：sudo systemctl start|restart|enable apache2 或 nginx
  • PHP-FPM：sudo systemctl start|restart|enable php[版本]-fpm（如 php8.2-fpm）
• 典型 Nginx FastCGI 片段
  • location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; }
• 安装验证
  • 创建 /var/www/html/info.php：
  • 浏览器访问 http://服务器IP/info.php，确认解析正常与扩展加载情况。

四 升级与兼容性管理

• 版本升级前使用 PHPCompatibility 等工具进行代码扫描，识别被移除/改动的函数、配置与语言特性差异。
• 采用分步升级策略（小版本递进），在测试环境充分回归后再上线；必要时使用多版本共存与灰度发布降低风险。
• 框架与依赖需与目标 PHP 版本匹配；对废弃 API 进行替换与适配，保持依赖库更新。

五 源码编译安装的前置依赖（可选）

• 基础编译工具：build-essential、gcc、g++、make、autoconf、cmake、m4、bison。
• 核心与网络：libxml2-dev、libssl-dev、libcurl4-openssl-dev、zlib1g-dev、libpcre3-dev。
• 图像与字体：libjpeg-dev、libpng-dev、libwebp-dev、libfreetype6-dev。
• 加密与口令学：libsodium-dev、libargon2-0-dev。
• 数据库驱动开发头文件（按需）：libmysqlclient-dev 或启用 mysqlnd（推荐）。