备案源头

PHP-FPM 环境与 Composer 准备

更新于 2026年8月21日

适用人群：准备在云服务器上为 PHP 框架搭建运行环境的开发者与运维。

核心概念

组件

  • Nginx：接收请求、转发 .php 给 PHP-FPM、服务静态资源。
  • PHP-FPM：PHP 的 FastCGI 进程管理器，实际执行 PHP 代码。
  • MySQL/MariaDB：多数框架应用的数据库。
  • Composer：PHP 依赖管理器，装框架和第三方库。

必备扩展

Laravel/ThinkPHP 常需 mbstring、openssl、pdo_mysql、tokenizer、xml、ctype、json、bcmath、fileinfo 等 PHP 扩展，缺失会导致 composer 安装或运行报错。

操作步骤

  1. 步骤 1装 Nginx + PHP-FPM + MySQL

    用包管理器或宝塔面板安装，PHP 选框架要求的版本（如 8.1/8.2）。

  2. 步骤 2装 PHP 扩展

    安装 mbstring、pdo_mysql、openssl、xml、bcmath、fileinfo 等框架必需扩展。

  3. 步骤 3装 Composer

    全局安装 Composer，用于安装框架依赖；国内可配置镜像加速。

  4. 步骤 4建数据库

    创建应用数据库与专用用户，字符集用 utf8mb4。

  5. 步骤 5验证

    php -v、php -m 确认版本与扩展，composer -V 确认可用。

实际示例

# Ubuntu 示例
apt install -y nginx mysql-server php8.2-fpm php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-curl php8.2-zip
systemctl enable --now nginx php8.2-fpm mysql

# 装 Composer
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

# 建数据库
mysql -e "CREATE DATABASE app DEFAULT CHARACTER SET utf8mb4;"

常见错误

  • ⚠️少装框架必需的 PHP 扩展，composer install 或运行时报缺扩展
  • ⚠️PHP 版本与框架要求不符（过低装不上、过高部分包未适配）
  • ⚠️数据库字符集用 utf8 而非 utf8mb4，存 emoji/生僻字出错
  • ⚠️Composer 没配国内镜像，境内拉依赖慢或失败

对应工具

数据库默认端口对照→MySQL 常用命令手册→

常见问题

PHP-FPM 是什么？
PHP 的 FastCGI 进程管理器，Nginx 把 .php 请求通过 fastcgi_pass 交给它执行。它是 PHP 应用实际运行的地方。
Composer 装依赖很慢怎么办？
境内可配置 Composer 国内镜像源加速，或在本地装好 vendor 后随代码一起部署。

相关教程

相关文章

官方资料来源