网站名称:php环境搭建|网址:www.xservx.com

PHP环境搭建权威指南

从零开始构建稳定、安全、高效的PHP运行环境,覆盖Windows/Linux/macOS全平台,集成Apache/Nginx/PHP-FPM组合方案,助您快速掌握开发环境部署与生产环境配置核心技能

开始学习

PHP环境搭建基础认知

理解PHP运行原理与环境组成要素,为后续部署实践奠定理论基础

什么是PHP运行环境?

PHP环境搭建是指在操作系统上配置支持PHP脚本执行所需的所有组件集合。一个标准的PHP环境包含Web服务器、PHP解析器、数据库系统及配套工具,共同构成LAMP(Linux+Apache+MySQL+PHP)或LEMP(Linux+Engine-X+MySQL+PHP)技术栈。

PHP作为服务器端脚本语言,其执行流程如下:浏览器发送HTTP请求至Web服务器,Web服务器将请求转发给PHP解释器,PHP脚本执行后生成HTML内容,再由Web服务器返回给浏览器展示。因此,php环境搭建的核心在于正确配置各组件间的协作关系。

环境组件详解

  • Web服务器:处理HTTP请求,支持CGI/FastCGI协议与PHP通信。Apache通过mod_php模块集成,Nginx则依赖php-fpm进程管理器。
  • PHP解析器:执行.php文件中的PHP代码。不同版本(如PHP 7.4、8.0、8.1、8.2)存在语法差异与性能特性变化,需根据项目需求选择。
  • 数据库系统:存储与管理数据。MySQL/MariaDB为开源主流选择,PostgreSQL提供更严格的SQL标准支持,SQLite适用于轻量级应用。
  • 辅助工具:phpMyAdmin管理数据库,Composer管理PHP依赖,Xdebug调试代码,Git进行版本控制。

环境搭建核心步骤

  1. 安装Web服务器(Apache/Nginx)并配置服务启动项
  2. 下载并安装对应版本的PHP,配置环境变量PATH
  3. 安装数据库系统,初始化root账户与基础数据库
  4. 配置Web服务器与PHP的集成方式(mod_php或php-fpm)
  5. 创建测试文件验证环境是否正常运行
  6. 调整配置文件优化性能与安全性

选择开发环境操作系统

不同操作系统在PHP开发中各有优势,需结合团队习惯与项目需求决策:

  • Windows:图形界面友好,集成工具丰富(XAMPP/WAMP/Laragon),适合初学者快速上手;但生产环境较少使用,存在性能瓶颈。
  • macOS:基于Unix内核,兼容Linux环境配置,开发体验接近生产环境;苹果生态用户首选,但硬件成本较高。
  • Linux:开源免费,生产环境主流系统,性能稳定;需要命令行操作基础,适合中高级开发者深入配置。

推荐实践路径:本地开发阶段使用Windows/macOS快速验证,部署上线前在Linux环境进行最终测试,确保环境一致性。

PHP版本选择策略

PHP版本迭代带来显著性能提升与新特性引入,合理选择版本至关重要:

  • PHP 7.4:最后的7.x版本,2022年11月停止维护,仅建议用于遗留系统维护。
  • PHP 8.0:重大版本升级,引入JIT编译器、联合类型、命名参数等特性,2023年11月停止主动支持。
  • PHP 8.1:新增readonly类、fibers异步协程、enum枚举类型,2024年11月停止主动支持。
  • PHP 8.2:当前最新稳定版,增强null/empty/true/false常量支持,移除部分废弃功能,2025年12月停止主动支持。
  • PHP 8.3:2023年12月发布,新增readonly类增强、new in initializers等特性,为长期支持版本。

建议新项目直接使用PHP 8.3,兼顾性能与特性支持;中大型项目可评估迁移到PHP 8.2;遗留系统需制定升级路线图。

开发与生产环境差异

开发环境与生产环境配置应严格区分,避免安全风险:

配置项 开发环境 生产环境
display_errors On Off
error_reporting E_ALL E_ERROR | E_WARNING | E_PARSE
log_errors On On
memory_limit 512M 128M
max_execution_time 300 30
zlib.output_compression Off On

集成开发工具对比

主流PHP集成环境工具功能与适用场景深度解析

XAMPP详解

XAMPP(Apache+MySQL+PHP+Perl)是跨平台开源集成环境,适合Windows/macOS/Linux用户快速搭建PHP开发环境。

安装步骤:

  1. 访问https://www.apachefriends.org下载对应系统安装包
  2. 运行安装程序,选择组件(建议全选)
  3. 安装完成后启动控制面板,点击Apache与MySQL的Start按钮
  4. 浏览器访问http://localhost验证安装成功

配置文件位置:

  • Apache配置:/xampp/apache/conf/httpd.conf
  • PHP配置:/xampp/php/php.ini
  • MySQL配置:/xampp/mysql/bin/my.ini

常见问题:

  • 端口冲突:80端口被Skype占用时,修改Apache配置Listen 8080,同时修改httpd.conf中ServerName为localhost:8080
  • MySQL权限问题:在控制面板中右键MySQL选择Run as Administrator
  • 虚拟主机配置:编辑httpd-vhosts.conf文件,取消httpd.conf中Include conf/extra/httpd-vhosts.conf注释

WAMP Server

WAMP(Windows+Apache+MySQL+PHP)专为Windows系统设计的集成环境,安装简洁,界面直观。

核心特性:

  • 绿色安装,无需注册表修改
  • 一键切换PHP/Apache版本(需额外下载)
  • 集成phpMyAdmin数据库管理工具
  • 支持多版本PHP共存(5.6/7.0/7.1/7.2/7.3/7.4/8.0)

版本管理技巧:

  1. 下载多个PHP版本压缩包(如php-7.4.33-Win32-vc15-x64.zip)
  2. 解压至WAMP安装目录/php/目录下新建子目录
  3. 右键WAMP托盘图标→PHP→Version→Add a PHP version
  4. 选择对应Apache版本与线程安全类型
  5. 切换版本时需重启所有服务

Laragon

Laragon是现代化轻量级集成环境,专为Windows开发者设计,强调速度与扩展性。

核心优势:

  • 秒级启动,内存占用低于50MB
  • 自动创建虚拟主机(*.test自动解析到localhost)
  • 支持多PHP版本快速切换(通过快捷键Ctrl+Alt+P)
  • 内置Git Bash终端与VS Code集成
  • 支持Nginx/Apache/MySQL/MariaDB/MongoDB全组合

虚拟主机配置:

在C:\laragon\etc\laragon\www目录下创建项目文件夹,如myproject,即可通过http://myproject.test访问,无需手动编辑hosts文件。

环境变量设置:

编辑C:\laragon\etc\laragon\laragon.ini文件,添加:

[env]
myapp.db_host=localhost
myapp.db_user=root
myapp.db_pass=
myapp.db_name=myapp

在代码中可通过getenv('myapp.db_host')获取配置值。

Docker环境搭建

Docker容器化方案实现环境一致性,适合团队协作与CI/CD集成。

Docker Compose配置示例:

version: '3.8'
services:
  php:
    image: php:8.3-fpm
    container_name: php-app
    volumes:
      - ./www:/var/www/html
    networks:
      - app-network
  nginx:
    image: nginx:alpine
    container_name: nginx-web
    ports:
      - "8080:80"
    volumes:
      - ./www:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php
    networks:
      - app-network
  mysql:
    image: mysql:8.0
    container_name: mysql-db
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: myapp
      MYSQL_USER: user
      MYSQL_PASSWORD: pass123
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - app-network
volumes:
  mysql-data:
networks:
  app-network:

运行命令:

docker-compose up -d
docker-compose exec php php -v

手动安装配置

手动安装提供最高灵活性,适合高级用户定制需求。

Windows手动安装步骤:

  1. 下载Apache二进制包(如httpd-2.4.57-win64-VS16.zip)
  2. 下载PHP非线程安全版(如php-8.3.0-nts-Win32-vs16-x64.zip)
  3. 下载MySQL安装器(mysql-installer-web-community-8.0.32.0.msi)
  4. 解压Apache至C:\Apache24,配置httpd.conf:
    ServerRoot "C:/Apache24"
    Listen 80
    ServerName localhost:80
    DocumentRoot "C:/Apache24/htdocs"
    LoadModule php_module "C:/php/php8apache2_4.dll"
    AddType application/x-httpd-php .php
    PHPIniDir "C:/php"
  5. 配置PHP:
    • 重命名php.ini-development为php.ini
    • 启用扩展:extension_dir = "ext"
    • 启用mysqli:extension=mysqli
    • 设置时区:date.timezone = Asia/Shanghai
  6. 安装Apache服务:httpd.exe -k install
  7. 启动服务验证环境

Web服务器配置详解

Apache与Nginx在PHP环境中的深度配置与性能优化

Apache配置PHP

Apache通过mod_php模块集成PHP,配置简单但内存占用较高。

关键配置项:

  • LoadModule php_module modules/libphp.so(Linux)或LoadModule php_module "C:/php/php8apache2_4.dll"(Windows)
  • AddType application/x-httpd-php .php
  • DirectoryIndex index.php index.html
  • php_value memory_limit 512M

虚拟主机配置示例:

<VirtualHost *:80>
    ServerName myapp.test
    DocumentRoot "C:/Apache24/htdocs/myapp"
    <Directory "C:/Apache24/htdocs/myapp">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog "logs/myapp-error.log"
    CustomLog "logs/myapp-access.log" combined
</VirtualHost>

Nginx配置PHP-FPM

Nginx通过FastCGI与php-fpm通信,性能优越,适合高并发场景。

配置文件nginx.conf关键部分:

location ~ \.php$ {
    root           /var/www/html;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

php-fpm配置(/etc/php/8.3/fpm/pool.d/www.conf):

[www]
user = nginx
group = nginx
listen = 127.0.0.1:9000
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35

性能调优建议:

  • 生产环境启用opcache扩展
  • 调整pm.max_children值(根据内存计算:总内存×70%÷单进程内存)
  • 开启slowlog记录慢请求
  • 配置request_terminate_timeout防止进程挂起

环境变量与配置分离

通过环境变量管理敏感信息,提升应用安全性与可移植性。

.env文件示例:

APP_NAME=MyApplication
APP_ENV=local
APP_KEY=base64:xxx
APP_DEBUG=true
APP_URL=http://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=root
DB_PASSWORD=secret
CACHE_DRIVER=file
QUEUE_CONNECTION=sync

Laravel配置读取:

// config/database.php
'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
],

生产环境安全实践:

  • .env文件加入.gitignore防止泄露
  • 使用env()函数而非直接访问$_SERVER
  • 生产环境禁用APP_DEBUG
  • 使用vault或AWS Secrets Manager管理密钥

常见故障排查指南

高频问题解决方案与诊断技巧

2023-08-15

500 Internal Server Error

Apache错误日志显示"PHP Fatal error: Allowed memory size exhausted"

解决方案:

  • 临时增加:ini_set('memory_limit', '512M');
  • 永久修改:php.ini中memory_limit = 512M
  • 检查循环引用与内存泄漏代码
  • 使用xdebug_profiler分析内存占用
2023-07-22

403 Forbidden

访问虚拟主机目录时返回403错误

解决方案:

  • 检查目录权限:chmod -R 755 /var/www/html
  • 确认SELinux状态:setenforce 0(临时禁用)
  • Apache配置AllowOverride All与Require all granted
  • Nginx配置root路径正确且有读权限
2023-06-10

MySQL连接失败

错误信息:"mysqli_connect(): (HY000/2002): No such file or directory"

解决方案:

  • 检查MySQL服务状态:systemctl status mysqld
  • 修改php.ini中mysqli.default_socket路径
  • 确认MySQL配置bind-address=127.0.0.1
  • 使用localhost而非127.0.0.1连接(Unix socket)
2023-05-03

PHP版本冲突

命令行php -v显示7.4,但浏览器中phpinfo()显示8.0

解决方案:

  • 检查PATH环境变量顺序
  • 使用which php定位实际执行路径
  • Apache使用php-fpm时确认版本一致性
  • 创建虚拟环境管理工具(如phpenv)
2023-04-18

CORS跨域问题

前端调用API时出现"Access-Control-Allow-Origin"错误

解决方案:

// Apache .htaccess
Header set Access-Control-Allow-Origin "*"
Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
Header set Access-Control-Allow-Headers "Content-Type, Authorization"
// Nginx配置
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
add_header Access-Control-Allow-Headers 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';
// PHP代码
header("Access-Control-Allow-Origin: *");
header("Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS");
header("Access-Control-Allow-Headers: Content-Type, Authorization");

诊断工具推荐

工具 功能 使用场景
phpinfo() 查看PHP配置详情 快速验证配置修改是否生效
error_log() 记录调试信息 生产环境安全日志输出
Xdebug 代码调试与性能分析 定位复杂逻辑错误
Blackfire 性能监控与分析 生产环境性能瓶颈诊断
phpstan 静态代码分析 提前发现潜在错误

日志定位技巧

Apache错误日志:

  • 默认位置:/var/log/httpd/error_log(Linux)或 C:\Apache24\logs\error.log(Windows)
  • 实时监控:tail -f /var/log/httpd/error_log
  • 过滤特定错误:grep "PHP Fatal" /var/log/httpd/error_log

php-fpm日志:

  • 配置项:error_log = /var/log/php-fpm/error.log
  • 慢请求日志:slowlog = /var/log/php-fpm/slow.log
  • 启用日志:request_slowlog_timeout = 5s

系统日志:

  • SELinux日志:/var/log/audit/audit.log
  • 系统服务日志:journalctl -u php-fpm.service
  • 防火墙日志:/var/log/firewalld

安全加固策略

生产环境安全配置最佳实践

基础安全配置

php.ini关键安全设置:

配置项 安全值 说明
expose_php Off 隐藏PHP版本信息
display_errors Off 生产环境禁用错误显示
log_errors On 启用错误日志记录
error_log /var/log/php_errors.log 指定错误日志路径
open_basedir /var/www/html 限制文件访问范围
disable_functions exec,passthru,system,shell_exec 禁用危险函数
session.cookie_httponly 1 防止JavaScript访问Cookie
session.cookie_secure 1 仅HTTPS传输Session

Web服务器安全

Apache安全配置:

# 隐藏版本信息
ServerTokens Prod
ServerSignature Off
# 禁用目录列表
Options -Indexes +FollowSymLinks
# 限制请求方法
<LimitExcept GET POST HEAD>
    Deny from all
</LimitExcept>
# 防止XXE攻击
PHP_INI_SCAN_DIR=/etc/php.d
libxml_disable_entity_loader(true);

Nginx安全配置:

# 隐藏版本信息
server_tokens off;
# 限制请求大小
client_max_body_size 10m;
# 防止点击劫持
add_header X-Frame-Options "SAMEORIGIN" always;
# 防止XSS攻击
add_header X-XSS-Protection "1; mode=block" always;
# 内容类型嗅探防护
add_header X-Content-Type-Options "nosniff" always;

数据库安全

MySQL安全加固:

  • 运行mysql_secure_installation脚本
  • 删除test数据库与匿名用户
  • 限制root远程访问:GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password';
  • 启用SSL连接:ALTER USER 'user'@'%' REQUIRE SSL;
  • 定期审计:SHOW GRANTS FOR 'user'@'host';

数据库权限最小化:

GRANT SELECT, INSERT, UPDATE ON myapp.* TO 'appuser'@'localhost' IDENTIFIED BY 'strong_password';
FLUSH PRIVILEGES;

应用层安全

PHP安全编码规范:

  • 输入验证:filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL)
  • 输出转义:htmlspecialchars($data, ENT_QUOTES, 'UTF-8')
  • SQL注入防护:使用PDO预处理语句
  • 文件上传验证:检查MIME类型与文件扩展名
  • 密码哈希:password_hash($password, PASSWORD_DEFAULT)
  • CSRF防护:生成并验证Token

安全扩展推荐:

  • Suhosin:PHP安全补丁
  • Security.ini:安全配置管理
  • PHP-PasswordLib:密码策略库

安全审计工具

工具 功能 安装命令
PHPStan 静态分析 composer require --dev phpstan/phpstan
Psalm 类型检查 composer require --dev psalm/phar
PHP Security Checker 依赖漏洞扫描 composer require --dev friendsofphp/security-checker
SecurityAudit 代码审计 php security_audit.phar run src/

性能优化指南

从PHP配置到Web服务器的全栈优化策略

Opcache配置优化

PHP 5.5+内置Opcache扩展,缓存预编译字节码显著提升性能。

php.ini配置:

zend_extension=opcache.so
opcache.enable=1
opcache.enable_cli=0
opcache.memory_consumption=256
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=100000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
opcache.fast_shutdown=1

验证配置:

php -d opcache.enable=1 -r 'echo opcache_get_status()["opcache_statistics"]["hits"];'

监控脚本:

<?php
phpinfo();
?>

访问页面查看Opcache状态,确认内存使用率与缓存命中率。

PHP-FPM进程管理

合理配置php-fpm进程数平衡资源与性能。

动态模式(推荐):

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20
pm.max_requests = 500

计算公式:

pm.max_children = (总内存 × 70%) ÷ 单进程内存占用

示例:服务器32GB内存,单进程约150MB → (32×1024×0.7)÷150 ≈ 150

慢请求日志:

request_slowlog_timeout = 5s
slowlog = /var/log/php-fpm/slow.log

MySQL性能调优

my.cnf关键配置:

[mysqld]
innodb_buffer_pool_size = 4G
innodb_log_file_size = 512M
innodb_flush_log_at_trx_commit = 2
max_connections = 500
query_cache_type = 1
query_cache_size = 64M
query_cache_limit = 4M
tmp_table_size = 128M
max_heap_table_size = 128M
table_open_cache = 2000
thread_cache_size = 50

性能分析命令:

SHOW VARIABLES LIKE 'innodb_buffer_pool_size';
SHOW STATUS LIKE 'Qcache_hits';
SHOW PROCESSLIST;

Nginx性能优化

核心配置:

worker_processes auto;
events {
    worker_connections 10240;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    tcp_nopush      on;
    tcp_nodelay     on;
    keepalive_timeout  65;
    gzip on;
    gzip_types text/plain text/css application/json application/javascript;
    gzip_min_length 1000;
    client_body_buffer_size 16k;
    client_header_buffer_size 1k;
    large_client_header_buffers 4 8k;
}

HTTP/2启用:

listen 443 ssl http2;

应用层优化

PHP代码优化建议:

  • 使用单例模式减少对象创建
  • 避免在循环中执行数据库查询
  • 使用unset()及时释放变量
  • 启用opcache且validate_timestamps=0(生产环境)
  • 使用apcu_cache_clear()定期清理缓存
  • 使用swoole扩展实现协程
  • 采用Redis缓存热点数据
  • 实施CDN加速静态资源

性能测试工具

工具 用途 示例命令
ab Apache Bench压力测试 ab -n 1000 -c 100 http://localhost/test.php
wrk 高性能HTTP基准测试 wrk -t4 -c100 -d30s http://localhost/test.php
Blackfire 代码级性能分析 blackfire run php script.php
APM工具 生产环境监控 New Relic / Datadog

PHP 7.x迁移至8.x指南

版本升级兼容性处理与新特性应用

主要差异对比

特性 PHP 7.4 PHP 8.0+
JIT编译器 无 默认启用(cli/web不同配置)
联合类型 不支持 支持int|string|null
命名参数 位置参数 支持function($name='value')
构造函数属性提升 不支持 支持class User {public function __construct(public string $name){}}
空合并赋值 需要isset检查 支持$a ??= 'default'
match表达式 switch语句 更安全的match表达式

兼容性问题修复

废弃函数处理:

废弃函数 替代方案
password_compat 使用内置password_hash()
mcrypt扩展 使用openssl扩展
filter_var_array()返回false 检查返回类型
str_replace()返回null 显式处理返回值

类型系统增强:

  • 添加declare(strict_types=1);声明严格模式
  • 使用类型提示:function test(int $id): string
  • 处理可空类型:?string $name
  • 使用union types:int|string|null

新特性应用示例

构造函数属性提升:

class User {
    public function __construct(
        public string $name,
        public int $age,
        public ?string $email = null
    ) {}
}
$user = new User("Alice", 30, "alice@example.com");
echo $user->name; // Alice

match表达式:

$status = match ($code) {
    200 => 'OK',
    400 => 'Bad Request',
    404 => 'Not Found',
    500 => 'Server Error',
    default => 'Unknown',
};

命名参数:

sendEmail(
    to: 'user@example.com',
    subject: 'Welcome',
    body: 'Hello!',
    from: 'noreply@example.com'
);

迁移步骤

  1. 检查PHP 7.4兼容性:php -d display_errors=1 -r 'echo "PHP 7.4 compatible";'
  2. 使用Rector工具自动升级代码:composer require --dev rector/rector
  3. 配置rector.php:
    use Rector\Core\Configuration\Option;
    use Rector\Set\ValueObject\SetList;
    return static function (ContainerConfigurator $container): void {
        $parameters->set(Option::SETS, [
            SetList::PHP_80,
        ]);
    };
  4. 运行自动升级:vendor/bin/rector process src/ --dry-run
  5. 手动修复无法自动转换的代码
  6. 全面测试所有功能模块
  7. 逐步部署至生产环境

测试策略

兼容性测试矩阵:

测试类型 工具 测试重点
单元测试 PHPUnit 函数返回值类型变化
集成测试 Codeception 数据库操作兼容性
性能测试 Blackfire JIT对性能影响
安全测试 SecurityAudit 新特性安全风险

Docker容器化部署

现代PHP应用容器化最佳实践

Dockerfile最佳实践

多阶段构建示例:

FROM php:8.3-fpm-alpine AS builder
WORKDIR /build
# 安装构建依赖
RUN apk add --no-cache \
    git \
    unzip \
    zlib-dev \
    libpng-dev \
    libjpeg-turbo-dev \
    libwebp-dev \
    freetype-dev
# 安装PHP扩展
RUN docker-php-ext-install \
    gd \
    mysqli \
    pdo \
    pdo_mysql \
    opcache
# 复制应用代码
COPY . .
# 安装Composer依赖
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
RUN composer install --optimize-autoloader --no-dev
# 生产镜像
FROM php:8.3-fpm-alpine AS production
WORKDIR /var/www/html
# 安装运行时依赖
RUN apk add --no-cache \
    libpng \
    libjpeg-turbo \
    libwebp \
    freetype \
    tzdata
# 设置时区
RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    echo "Asia/Shanghai" > /etc/timezone
# 复制构建产物
COPY --from=builder /build /var/www/html
# 配置PHP
COPY config/php.ini /usr/local/etc/php/conf.d/custom.ini
# 设置权限
RUN chown -R www-data:www-data /var/www/html
EXPOSE 9000
CMD ["php-fpm"]

Docker Compose编排

完整应用栈配置:

version: '3.8'
services:
  app:
    build:
      context: .
      target: production
    container_name: php-app
    volumes:
      - ./app:/var/www/html
      - ./logs:/var/www/html/storage/logs
    environment:
      - APP_ENV=production
      - APP_DEBUG=false
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=app
      - DB_USERNAME=app
      - DB_PASSWORD=secret123
    depends_on:
      - redis
      - db
    networks:
      - app-network
  nginx:
    image: nginx:alpine
    container_name: nginx-proxy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./app:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d
      - ./certs:/etc/nginx/certs
    depends_on:
      - app
    networks:
      - app-network
  db:
    image: mysql:8.0
    container_name: mysql-db
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: app
      MYSQL_USER: app
      MYSQL_PASSWORD: secret123
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - app-network
  redis:
    image: redis:7-alpine
    container_name: redis-cache
    volumes:
      - redis-data:/data
    networks:
      - app-network
volumes:
  mysql-data:
  redis-data:
networks:
  app-network:
    driver: bridge

生产环境配置

安全加固措施:

  • 使用非root用户运行容器
  • 限制容器资源:mem_limit=1g, cpu_quota=50000
  • 启用只读根文件系统:--read-only
  • 禁用容器内特权模式:--cap-drop=ALL
  • 定期扫描镜像漏洞:docker scan image-name

监控与日志:

docker run -d \
  --name app \
  --memory="1g" \
  --cpus="1.0" \
  --read-only \
  --cap-drop=ALL \
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  php:8.3-fpm

Kubernetes部署

基础Deployment配置:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: php-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: php-app
  template:
    metadata:
      labels:
        app: php-app
    spec:
      containers:
      - name: php-app
        image: php:8.3-fpm
        ports:
        - containerPort: 9000
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "500m"
        env:
        - name: APP_ENV
          value: "production"
        volumeMounts:
        - name: app-volume
          mountPath: /var/www/html
      volumes:
      - name: app-volume
        persistentVolumeClaim:
          claimName: app-pvc