Debian PHP如何安装和配置

Debian 上安装与配置 PHP 的完整步骤

一 准备与版本选择

• 更新索引并确认可用版本：
  • sudo apt update
  • apt-cache policy php
• 在 Debian 12 上，直接安装 php 通常得到 PHP 8.2；如需特定版本（如 7.4/8.1/8.2），可安装对应元包或版本化包（如 php7.4、php8.2）。安装完成后用 php -v 校验。

二 安装 PHP 与常用扩展

• 安装基础包与常用扩展（按需增删）：
  • sudo apt install php php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath
• 若使用 Nginx，务必安装 php-fpm；若使用 Apache 且采用模块方式，安装 libapache2-mod-php。安装完成后可 systemctl status php-fpm 查看 FPM 状态。

三 配置 PHP 与 PHP-FPM

• 配置文件路径（按 SAPI 区分）：
  • CLI：/etc/php//cli/php.ini
  • FPM：/etc/php//fpm/php.ini
• 常用性能与安全项（示例值，按业务调整）：
  • memory_limit = 256M
  • upload_max_filesize = 100M
  • post_max_size = 100M
  • max_execution_time = 300
  • opcache.enable = On
  • opcache.memory_consumption = 64
  • opcache.max_accelerated_files = 4000
• FPM 池配置（/etc/php///fpm/pool.d/www.conf）：
  • listen = /run/php/php-fpm.sock
  • listen.owner = www-data；listen.group = www-data
  • user = www-data；group = www-data
• 生效与验证：
  • sudo systemctl restart php****-fpm
  • php -i | grep opcache.enable 或创建 phpinfo 页面核对。

四 与 Web 服务器集成

• Nginx 示例（站点配置片段）：
  • location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php****-fpm.sock; }
  • 修改后执行：sudo nginx -t && sudo systemctl restart nginx
• Apache 两种常见方式：
  • 模块方式（libapache2-mod-php）：安装后启用对应模块并重启
    • sudo a2enmod php****；sudo systemctl restart apache2
  • FPM 方式（推荐与 Nginx 一致使用 FPM）：
    • sudo a2enmod proxy_fcgi setenvif
    • 在 VirtualHost 中使用 SetHandler：
      • <FilesMatch .php$> SetHandler “proxy:unix:/run/php/php****-fpm.sock|fcgi://localhost”
    • sudo systemctl restart apache2

五 验证与常用维护

• 验证安装：
  • echo “” | sudo tee /var/www/html/info.php
  • 浏览器访问：http://服务器IP/info.php（生产环境请删除该文件）
• 多版本并存与切换（示例思路）：
  • 同时安装多个版本（如 php7.4、php8.2），通过安装对应的 libapache2-mod-phpX.Y 启用某版本模块，或在不同站点使用不同 FPM 套接字（/run/php/phpX.Y-fpm.sock）分流。
• 调试与开发：
  • 安装调试器：sudo apt install php-xdebug
  • 在 php.ini 中启用（示例）：
    • zend_extension=xdebug.so
    • xdebug.mode=debug
    • xdebug.client_host=127.0.0.1
    • xdebug.client_port=9003
  • 重启 Web 服务或 FPM 后配合 IDE 调试。