CentOS Stream 9 系统上安装 PHP 8.0.30 及其扩展的步骤

以下是完整的在 CentOS Stream 9 系统上安装 PHP 8.0.30 及其扩展的步骤总结。整个过程包括安装 PHP、配置环境、安装扩展以及验证安装。

1. 系统准备

确保系统已更新到最新版本：

 sudo dnf update -y

2. 添加 Remi 仓库

Remi 仓库提供了 PHP 8.0 的稳定版本：

 sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm

3. 启用 PHP 8.0 模块

启用 Remi 仓库中的 PHP 8.0 模块：

 sudo dnf module reset php
 sudo dnf module enable php:remi-8.0

4. 安装 PHP 8.0.30

安装 PHP 8.0.30 及其常用组件：

 sudo dnf install -y php php-cli php-fpm php-common

5. 验证 PHP 安装

检查 PHP 版本，确认安装成功：

 php -v

6. 安装常用扩展

根据 Laravel 和 Webman 的需求，安装以下扩展：

 sudo dnf install -y 
     php-bcmath 
     php-ctype 
     php-curl 
     php-dom 
     php-fileinfo 
     php-filter 
     php-hash 
     php-iconv 
     php-json 
     php-libxml 
     php-mbstring 
     php-openssl 
     php-pcre 
     php-pdo 
     php-pdo_mysql 
     php-phar 
     php-posix 
     php-session 
     php-simplexml 
     php-tokenizer 
     php-xml 
     php-xmlreader 
     php-xmlwriter 
     php-zip 
     php-zlib 
     php-opcache

7. 安装其他可选扩展

根据需求安装以下扩展：

 sudo dnf install -y 
     php-gd 
     php-imagick 
     php-intl 
     php-redis 

8. 配置 PHP-FPM

编辑 PHP-FPM 配置文件（通常位于 /etc/php-fpm.d/www.conf），确保以下配置正确：

 listen = /run/php-fpm/www.sock
 user = nginx
 group = nginx

9. 配置 Nginx

编辑 Nginx 配置文件（如 /etc/nginx/conf.d/default.conf），添加 PHP 支持：

 server {
     listen 80;
     server_name your_domain.com;
 ​
     root /var/www/html;
     index index.php index.html index.htm;
 ​
     location / {
         try_files $uri $uri/ =404;
     }
 ​
     location ~ .php$ {
         include fastcgi_params;
         fastcgi_pass unix:/run/php-fpm/www.sock;
         fastcgi_index index.php;
         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
     }
 }

10. 启动并启用服务

启动 PHP-FPM 和 Nginx 服务，并设置为开机自启：

 sudo systemctl start php-fpm
 sudo systemctl enable php-fpm
 sudo systemctl start nginx
 sudo systemctl enable nginx

11. 验证安装

1. 创建测试 PHP 文件：

    echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/index.php

2. 访问测试页面： 在浏览器中访问 http://your_domain.com/index.php，确认 PHP 信息页面正常显示。

3. 检查已加载的扩展：

    php -m

12. 解决常见问题

1. 扩展未加载： • 检查扩展是否已安装：

    sudo dnf list installed | grep php

   • 确保扩展配置文件存在于 /etc/php.d/ 目录中。

2. Nginx 无法连接 PHP-FPM： • 检查 PHP-FPM 和 Nginx 的配置文件，确保 fastcgi_pass 路径一致。 • 检查 PHP-FPM 服务是否正常运行：

    sudo systemctl status php-fpm

3. 字符编码问题： • 确保 php-mbstring 扩展已安装并启用。 • 检查 PHP 配置文件中的 default_charset 设置：

    default_charset = "UTF-8"

总结

通过以上步骤，你可以在 CentOS Stream 9 系统上成功安装 PHP 8.0.30 及其扩展，并配置 Nginx 和 PHP-FPM 以支持 Laravel 和 Webman 应用。如果遇到问题，可以根据日志和错误信息进行排查。