04.8 阶段 7:部署、安全与综合项目
本页目录
一、阶段定位
前六个阶段解决"业务系统怎么写得对、跑得快"。本阶段解决"业务系统怎么安全地、可重复地、可回滚地部署上线"。PHP 项目上线后的事故,一半是部署问题(配置错、密钥泄露、权限错),一半是安全问题(注入、XSS、越权)。本阶段把这两块串成一条可执行的上线流程。
与前后阶段的衔接:往上是 04.7 阶段 6 FPM 性能与常驻内存,本阶段把 Opcache、FPM 参数、压测报告放进 Docker 镜像与 CI/CD;往下接 04.9 阶段 8 进阶方向(可选),那里讨论分布式事务、服务化拆分。跳过本阶段直接学进阶,会在"为什么容器里扩展装不上""为什么线上配置里硬编码了数据库密码""为什么文件上传被拿到 shell"这些问题上反复返工。
原始卡点展开成可判断的现象依据:
- 只做功能不做鉴权校验:判断标准是接口能查别人的订单(水平越权),或普通用户能调管理员接口(垂直越权)。
- 配置里硬编码密钥与数据库密码:判断标准是
config/database.php里直接写'password' => 'secret123',且这个文件提交到了 Git。 - 只防 SQL 注入,忽略 XSS、上传与越权:判断标准是预处理语句用了,但用户提交的 HTML 直接渲染到页面,或上传文件没校验扩展名。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能写出生产级 Nginx + FPM 配置 | 配置含 HTTPS、gzip、静态缓存、fastcgi 缓存 |
| 能用 Docker 多阶段构建 PHP 镜像 | docker build 产出镜像,docker run 起服务 |
| 能配 CI/CD 流水线,含测试与静态分析门禁 | PR 不通过门禁不能合并 |
| 能识别并修复 SQL 注入、XSS、CSRF、文件上传、反序列化、SSRF、越权 | 用 OWASP 清单逐项自查 |
| 能把密钥与配置从代码里剥离,用环境变量注入 | Git 仓库里搜不到明文密码 |
| 能做一次灰度发布与回滚演练 | 回滚到上一版本时间 < 5 分钟 |
建议学时:
- 全职(每天 4–6 小时):2.5 周,约 70 小时。
- 在职(每天 2 小时、周末补 4 小时):5 周,约 70 小时。
学时分配:Nginx 生产配置 10%、Docker 镜像 20%、CI/CD 15%、安全七项 35%、密钥与日志 20%。安全七项是面试与事故重灾区,时间给够。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Nginx + FPM | 站点可访问 | 04.1 阶段 0 环境与工程基础 |
| Laravel 或原生 PHP 服务 | 有一个可部署的项目 | 04.5 阶段 4 框架主线 Laravel |
| 性能优化 | 有压测报告 | 04.7 阶段 6 FPM 性能与常驻内存 |
| Docker 基础 | docker run、docker ps |
不属本篇 |
经验判断:写过运维的人会把本阶段当本职;写开发的人最容易忽略"配置与密钥"与"日志可观测",这两块是事故复盘时的高频扣分项。
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| Nginx 生产配置 | HTTPS、gzip、静态缓存、fastcgi 缓存、超时 | 会用 | 01.2 计算机网络 |
| Docker 镜像 | 多阶段构建、PHP 扩展安装、docker-php-ext-install |
会用 | 08.1 容器化 |
| CI/CD | 流水线、测试门禁、灰度、回滚 | 会用 | 08.4 CI/CD 与可观测性 |
| SQL 注入 | 预处理边界、ORM 安全边界 | 能讲清原理 | 11.4 安全与合规 |
| XSS/CSRF | 输出转义、富文本过滤、Token | 会用 | 11.4 安全与合规 |
| 文件上传与反序列化 | 类型校验、存储隔离、二次渲染、unserialize 白名单 |
会用 | 11.4 安全与合规 |
| SSRF 与越权 | URL 白名单、水平/垂直越权 | 会用 | 11.4 安全与合规 |
| 密钥与日志 | 环境变量、密钥管理、日志采集、监控告警 | 会用 | 08.4 CI/CD 与可观测性 |
进度管理建议:安全七项能逐项口述修复方案再进阶段 8。全量清单见 04.10 知识点全清单。
五、分模块精讲
5.1 Nginx + FPM 生产配置
为什么需要它:开发配置直接上生产是事故来源。生产配置要做 HTTPS、gzip、静态资源缓存、超时控制。
核心机制:
- HTTPS:证书 +
listen 443 ssl,HTTP 80 跳转 443。 - gzip:压缩文本响应,减少带宽。
- 静态资源缓存:
expires 30d,让浏览器缓存 CSS/JS/图片。 - fastcgi 缓存:对不常变的页面缓存 Nginx 层,直接返回不打 FPM。
- 超时:
fastcgi_connect_timeout、fastcgi_read_timeout,防止慢请求占满连接。
最小可运行示例:
server {
listen 80;
server_name shop.test;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name shop.test;
root /var/www/shop/public;
index index.php;
ssl_certificate /etc/ssl/shop.crt;
ssl_certificate_key /etc/ssl/shop.key;
gzip on;
gzip_types text/css application/javascript application/json;
location ~* \.(css|js|png|jpg)$ {
expires 30d;
add_header Cache-Control "public";
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 60;
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 静态资源不缓存 | 没配 expires | 加 expires 30d |
| 响应没压缩 | 没开 gzip | 加 gzip 配置 |
| HTTP 不跳转 HTTPS | 没配 80 跳转 | 加 301 |
面试考法:"Nginx 生产要做哪些优化"。答到:HTTPS、gzip、静态缓存、超时、fastcgi 缓存。
5.2 Docker 多阶段构建与 PHP 扩展
为什么需要它:把 PHP + 扩展 + 依赖打成镜像,开发/测试/生产环境一致。多阶段构建让镜像更小。
核心机制:
- 多阶段:第一阶段装 composer 依赖,第二阶段只跑 PHP 运行时,不复制 composer 源码。
- PHP 扩展:
docker-php-ext-install pdo_mysql mbstring opcache;PECL 扩展用pecl install redis && docker-php-ext-enable redis。 - 生产镜像不要
--no-dev装的 dev 依赖。
最小可运行示例:
# 阶段 1:装依赖
FROM composer:2 as vendor
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader --no-scripts
# 阶段 2:运行时
FROM php:8.2-fpm
# 安装系统依赖
RUN apt-get update && apt-get install -y libpng-dev libzip-dev \
&& docker-php-ext-install pdo_mysql mbstring opcache gd zip \
&& pecl install redis && docker-php-ext-enable redis
# 复制代码与依赖
COPY . /var/www/shop
COPY --from=vendor /app/vendor /var/www/shop/vendor
WORKDIR /var/www/shop
RUN chown -R www-data:www-data storage bootstrap/cache
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 镜像里没装 redis 扩展 | 只用 docker-php-ext-install |
用 pecl install redis |
| 镜像体积大 | 没多阶段 | 拆成两阶段 |
| storage 权限错 | 没 chown | 加 chown -R www-data |
面试考法:"为什么用多阶段构建""PHP 扩展怎么装"。答到:减少最终镜像体积;docker-php-ext-install 装官方扩展,pecl install 装 PECL 扩展。
5.3 CI/CD 流水线与灰度回滚
为什么需要它:手工部署必出错。流水线把"测试 → 静态分析 → 构建镜像 → 部署"自动化。
核心机制:
- 流水线阶段:
lint(CS-Fixer)→phpstan→phpunit→build(Docker)→deploy。 - 门禁:任何阶段失败,PR 不能合并。
- 灰度:先切 10% 流量到新版本,观察无异常再全量。
- 回滚:保留上一版本镜像,出问题一键切回。
最小可运行示例(GitHub Actions 概念):
# .github/workflows/ci.yml
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: php-actions/composer@v6
with:
args: install --no-dev
- run: ./vendor/bin/phpunit
- run: ./vendor/bin/phpstan analyse src --level=5
- run: ./vendor/bin/php-cs-fixer fix --dry-run
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| CI 通过线上报错 | CI 与生产环境不一致 | 用同一 Docker 镜像 |
| 回滚慢 | 没保留旧镜像 | 保留最近 N 个镜像 |
面试考法:"怎么做灰度发布""回滚流程"。答到:按比例切流量,观察指标;保留旧镜像一键切回。
5.4 SQL 注入与 XSS/CSRF
为什么需要它:这是 Web 安全的三大基础。预处理防注入,输出转义防 XSS,Token 防 CSRF。
核心机制:
- SQL 注入:预处理占位符;表名/排序字段白名单。
- XSS:
- 存储型:用户提交的内容存库,渲染到其他用户页面;
- 反射型:URL 参数直接输出;
- 修复:输出时
htmlspecialchars($x, ENT_QUOTES, 'UTF-8');富文本用 HTML Purifier 白名单过滤。
- CSRF:利用登录态发起非预期请求;修复:表单带
csrf_token,后端校验。
最小可运行示例:
<?php
// 防 XSS:输出转义
echo htmlspecialchars($userInput, ENT_QUOTES, 'UTF-8');
// 防 CSRF:表单 Token
session_start();
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
if (!hash_equals($_SESSION['csrf'] ?? '', $_POST['csrf'] ?? '')) {
http_response_code(419);
exit('CSRF token mismatch');
}
}
$_SESSION['csrf'] = bin2hex(random_bytes(16));
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 富文本提交后页面被脚本攻击 | 只转义不过滤 | 用 HTML Purifier 白名单 |
| 接口被 CSRF | 没校验 Token | 加 csrf_token |
面试考法:"存储型 XSS 与反射型区别""预处理为什么能防注入"。答到:存储型存库后危害所有用户;反射型通过 URL 触发;预处理分开发送 SQL 与参数。
5.5 文件上传与反序列化漏洞
为什么需要它:文件上传是 get shell 的常见入口;unserialize 是 PHP 历史上最大的反序列化漏洞来源。
核心机制:
- 文件上传安全:
- 校验扩展名白名单(不是黑名单);
- 校验 MIME 类型与文件头;
- 存到非 Web 目录或对象存储,不允许直接执行;
- 图片二次渲染,剥离恶意代码;
- 重命名文件,不保留用户文件名。
- 反序列化:
- 不要
unserialize用户输入; - 必须用
unserialize($data, ['allowed_classes' => false]); - 优先用 JSON 序列化。
- 不要
最小可运行示例:
<?php
// 安全的文件上传
$allowed = ['image/jpeg', 'image/png', 'image/gif'];
$mime = mime_content_type($_FILES['file']['tmp_name']);
if (!in_array($mime, $allowed)) {
exit('不允许的文件类型');
}
// 重命名 + 存到非 Web 目录
$newName = bin2hex(random_bytes(16)) . '.jpg';
move_uploaded_file($_FILES['file']['tmp_name'], '/var/www/uploads/' . $newName);
// 安全的反序列化
$data = unserialize($input, ['allowed_classes' => false]);
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
上传 .php 被执行 |
没校验扩展名 | 白名单校验 + 存到非执行目录 |
| 图片里嵌 PHP 代码 | 没二次渲染 | 用 imagecreatefromjpeg 重新渲染 |
unserialize 用户输入 |
反序列化漏洞 | 用 allowed_classes=false,或改 JSON |
面试考法:"文件上传怎么防 get shell""为什么不要 unserialize 用户输入"。答到:白名单 + 二次渲染 + 存储隔离;unserialize 会触发 __wakeup 魔术方法链,导致 RCE。
5.6 SSRF 与越权
为什么需要它:服务端请求伪造让你的服务器替攻击者发请求;越权让用户访问别人的数据。
核心机制:
- SSRF:用户传 URL,服务器去请求。攻击者传内网地址(如
http://169.254.169.254/云元数据)。修复:URL 白名单、禁止内网 IP、校验协议只允许 http/https。 - 水平越权:用户 A 能查用户 B 的订单(
/orders/123,123 是 B 的)。修复:查询时加where user_id = 当前用户。 - 垂直越权:普通用户能调管理员接口。修复:中间件校验角色。
最小可运行示例:
<?php
// 防水平越权:查询带当前用户
$order = Order::where('id', $orderId)
->where('user_id', auth()->id()) // 关键:限制归属
->first();
if (!$order) abort(403);
// 防 SSRF:URL 白名单
$allowedHosts = ['api.wechat.com', 'open.alipay.com'];
$host = parse_url($url, PHP_URL_HOST);
if (!in_array($host, $allowedHosts)) {
throw new RuntimeException('不允许的目标地址');
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 用户能看别人订单 | 没加 user_id 条件 |
查询带归属 |
| 普通用户能调管理员接口 | 中间件没校验角色 | 加 role:admin 中间件 |
| SSRF 打到内网 | 没校验 host | 白名单 + 禁内网 IP |
面试考法:"水平越权与垂直越权区别""SSRF 怎么防"。答到:水平是同角色跨用户,垂直是跨角色;白名单 + 禁内网 IP。
5.7 密钥与配置管理
为什么需要它:硬编码密钥是最常见也最低级的事故。密钥必须从代码里剥离,用环境变量注入。
核心机制:
- 开发环境用
.env文件(加.gitignore); - 生产环境用容器环境变量、K8s Secret、或专用密钥管理服务(Vault);
- 代码里用
env('DB_PASSWORD')读,不硬编码; - 密钥轮换:定期更换,泄露后能立即吊销。
最小可运行示例:
<?php
// config/database.php
return [
'default' => 'mysql',
'connections' => [
'mysql' => [
'host' => env('DB_HOST', '127.0.0.1'),
'password' => env('DB_PASSWORD'), // 从环境变量读,不硬编码
],
],
];
# .gitignore
.env
.env.production
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| Git 历史里有明文密码 | 提交了 .env | 立即轮换密钥,git filter-branch 清除 |
| 配置在代码里写死 | 没用 env | 改 env() 读 |
面试考法:"密钥泄露了怎么办"。答到:立即轮换所有受影响密钥,审计访问日志,清除 Git 历史。
5.8 日志采集与监控告警
为什么需要它:出问题时没有日志就是盲人。日志要集中采集,关键指标要告警。
核心机制:
- 日志:按 PSR-3 分级,结构化 JSON 输出,带 trace_id 串联请求。
- 采集:Filebeat/Fluentd 把日志送到 Elasticsearch/Loki。
- 监控:QPS、P99、错误率、CPU/内存/磁盘、MySQL 连接数。
- 告警:错误率超阈值、P99 超阈值、磁盘超 80% 时通知。
最小可运行示例:
<?php
// 结构化日志
$logger->info('订单创建', [
'trace_id' => $request->header('X-Trace-Id'),
'order_id' => $order->id,
'amount' => $order->amount,
]);
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 日志里有密码 | 上下文带敏感字段 | 只记 ID 与结果 |
| 出问题找不到日志 | 没集中采集 | 接 Filebeat/ELK |
| 故障没人知道 | 没告警 | 配错误率与 P99 告警 |
面试考法:"日志里能不能写敏感信息""怎么定位一个线上故障"。答到:不能;trace_id 串联 → 日志检索 → 监控看板 → 慢请求定位。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 写生产 Nginx 配置 | HTTPS + gzip + 静态缓存 | curl -I 看到 Content-Encoding: gzip |
1.5 小时 |
| 写 Dockerfile | 多阶段构建,装 pdo_mysql/redis | docker run 起服务 |
2 小时 |
| 配 CI 流水线 | 跑 test+phpstan+cs | PR 失败门禁生效 | 2 小时 |
| 修一个 SQL 注入 | 拼接 SQL 改预处理 | 注入 payload 失败 | 1 小时 |
| 修一个 XSS | 输出加 htmlspecialchars | 脚本不执行 | 1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 文件上传加固 | 白名单 + 重命名 + 二次渲染 | .php 上传被拒 |
2 小时 |
| 越权修复 | 订单查询加 user_id | 访问别人订单返回 403 | 1 小时 |
| 密钥剥离 | 把硬编码密码改 env | Git 仓库搜不到明文 | 1 小时 |
| 灰度发布演练 | 切 10% 流量观察 | 全量后无异常 | 2 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 综合项目 | 见 04.13 实战项目阶梯 项目五 | 部署文档 + 安全自检表 | 20 小时 |
| 安全自检表 | 写一份 OWASP 逐项清单 | 团队 review 无遗漏 | 2 小时 |
| 回滚演练 | 出问题切回上一版本 | < 5 分钟 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 容器里 redis 扩展找不到 | 只用 docker-php-ext-install | 看 php -m | 用 pecl install |
| Git 历史里有密码 | 提交了 .env | git log -p |
轮换密钥 + 清历史 |
| 上传 .php 被执行 | 没校验类型 | 看上传目录 | 白名单 + 存储隔离 |
| 用户能看别人订单 | 没加 user_id | 看 SQL where | 查询带归属 |
| 普通用户能调管理员接口 | 中间件没校验 | 看路由中间件 | 加 role:admin |
| 响应没压缩 | 没开 gzip | curl -I |
加 gzip |
| 出问题找不到日志 | 没集中采集 | 看日志文件 | 接 Filebeat/ELK |
| 回滚慢 | 没保留旧镜像 | 看镜像列表 | 保留最近 N 个 |
八、出口条件
全部勾选后进入 04.9 阶段 8 进阶方向(可选)。
- [ ] 能写生产级 Nginx + FPM 配置,含 HTTPS/gzip/缓存
- [ ] 能用 Docker 多阶段构建 PHP 镜像
- [ ] 能配 CI/CD 流水线,含测试与静态分析门禁
- [ ] 能逐项识别并修复 SQL 注入、XSS、CSRF、上传、反序列化、SSRF、越权
- [ ] 能把密钥从代码剥离,用环境变量注入
- [ ] 能做一次灰度发布与回滚演练
- [ ] 排障表随机抽三个现象,5 分钟内给出排查路径
自测题:
- 为什么要用 Docker 多阶段构建?
- 要点:减少最终镜像体积,把构建工具与运行时分离。
- 预处理为什么能防 SQL 注入?表名能占位吗?
- 要点:SQL 模板与参数分开发送;表名是结构,必须白名单。
- 文件上传怎么防 get shell?
- 要点:白名单 + 校验文件头 + 存到非执行目录 + 二次渲染 + 重命名。
- 水平越权与垂直越权区别?
- 要点:水平是同角色跨用户(A 看 B 的订单);垂直是跨角色(普通用户调管理员)。
- 为什么不要
unserialize用户输入?- 要点:会触发魔术方法链导致 RCE;用
allowed_classes=false或改 JSON。
- 要点:会触发魔术方法链导致 RCE;用
- 密钥泄露了第一步做什么?
- 要点:立即轮换所有受影响密钥,再审计日志。
- CI/CD 门禁有哪些?
- 要点:代码风格、静态分析、单元测试、镜像构建;任何一项失败不能合并。