罗罗编程学习记录
本页内容 展开查看

04.1 阶段 0:环境与工程基础

所属:全栈开发面试题库 / 学习路径 / 04 PHP 全栈

本页目录

一、阶段定位

本阶段不写业务代码,只解决一件事:让一段 PHP 脚本能从浏览器或 curl 访问到,并能说清中间每一跳发生了什么。很多人跳过这一步直接学语法,后面所有"本地 CLI 跑得好好的、Nginx 下 502""扩展 CLI 有、FPM 没有"的问题,根源都在这一阶段没摸清。

阶段 0 与前后的衔接:它往上是零要求(只要会开终端、会用编辑器),往下接 04.2 阶段 1 语言核心。语言核心里所有示例都要用 php 命令跑;一旦到了阶段 4 上 Laravel,就是 Nginx + FPM + Opcache 的完整链路。如果现在分不清"CLI 跑的 PHP 与 FPM 跑的 PHP 是不是同一个二进制、读的是不是同一份 ini",后面调扩展、调 memory_limit、调 Opcache 命中率时一定会反复踩同一个坑。

本阶段原始卡点展开成可判断的现象依据:

  • 环境扩展装不上:判断标准是 php -m 里看不到 pdo_mysql、redis、mbstring 中任意一个,但你以为自己装过了;或 CLI 下有该扩展、phpinfo() 的 Web 页面里没有。
  • 分不清 CLI 配置与 FPM 配置:判断标准是改完 php.ini 里 memory_limit,CLI 下 php -i | grep memory_limit 变了,但 FPM 下 phpinfo() 还是旧值——说明你改的不是 FPM 读的那份 ini。
  • 把"命令行跑通"误当"Web 跑通":判断标准是 php index.php 输出正常,但浏览器访问站点出现 No input file specified.、File not found. 或 502,因为 Nginx 根本没把请求正确转发给 FPM。

二、阶段目标与投入

学完本页,应能用可观察的行为证明以下六条能力:

能力目标(可验证的行为) 验证方式
能独立装好 PHP 8.x 并确认版本与已加载扩展 php -v 输出 8.x,php -m 含 pdo_mysql、mbstring、openssl
能说清 CLI 与 FPM 分别加载哪份 php.ini php --ini 与 phpinfo() 对比,能指出两份路径的差异
能用 php -S 内置服务器与 Nginx + FPM 两种方式跑通 hello 页面 浏览器与 curl -i 都返回 200,且响应头含 X-Powered-By: PHP/8.x
能看懂 Nginx 最小站点配置并把请求转发到 FPM try_files + fastcgi_pass + SCRIPT_FILENAME 三件套配齐
能用 curl 发请求、看状态码、定位 404/502/500 分别是哪一跳出问题 curl -i 能区分"Nginx 直接 404"与"PHP 返回 500"
能把脚本纳入 Git 并留下至少两次提交记录 git log --oneline 有提交,git status 干净

建议学时:

  • 全职(每天 4–6 小时):1 周,约 30 小时。
  • 在职(每天 2 小时、周末补 3 小时):2–3 周,约 30 小时。

学时分配:安装与版本管理 20%、CLI 与内置服务器 15%、php.ini 与扩展 20%、Nginx+FPM 配置 25%、HTTP 链路与 curl 10%、Git 与命令行 10%。

三、先修自检

先修项 合格标准 不合格时回到
终端基本操作 能 cd、ls、pwd、mkdir,能看懂相对路径与绝对路径 本机终端入门教程,不属本篇
编辑器 能用 VS Code 或 PhpStorm 保存 UTF-8 无 BOM 的 .php 文件 本机编辑器设置
Git 概念 知道工作区、暂存区、提交三个概念 不属本篇,先做一次 init/add/commit
HTTP 概念 知道请求方法、状态码、请求头与响应头是什么 01.2 计算机网络

经验判断:如果你以前只在 Windows 上用过 phpStudy、WAMP 这类集成包,本阶段最需要警惕的是"集成包把一切藏起来了"——你看不到 php.ini 在哪、看不到 Nginx 配置,出问题只能换集成包版本。本阶段要在系统上用包管理器或手动方式把 PHP 装一遍,哪怕只装一个 CLI。

四、知识地图

"掌握程度"分三档:了解、会用、能讲清原理。

模块 知识点 掌握程度 对应题库章节
PHP 安装 版本选择(8.1/8.2/8.3)、php -v、php -m、php --ini 会用 04.5 PHP
CLI 运行 php file.php、php -r "..."、php -S localhost:8000 会用 04.5 PHP
php.ini memory_limit、max_execution_time、display_errors、error_reporting、date.timezone、extension_dir 能讲清原理 04.5 PHP
扩展安装 pdo_mysql、mbstring、openssl、curl、gd、redis 的作用与加载方式 会用 04.5 PHP
Nginx + FPM server 块、root、index、try_files、fastcgi_pass、SCRIPT_FILENAME 能讲清原理 01.2 计算机网络
HTTP 链路 浏览器→Nginx→FPM→PHP→响应,状态码 200/301/404/500/502 能讲清原理 01.2 计算机网络
Linux 与 Git ls/ps/tail/chmod、git init/add/commit/log/status 会用 不属题库分册,属通用工程

进度管理建议:把上表复制到笔记,每学完一个模块把"掌握程度"往下调一档;CLI 与 FPM 两份 ini 的差异能口述清楚后,再进 04.2 阶段 1 语言核心。全量清单见 04.10 知识点全清单。

五、分模块精讲

5.1 PHP 安装与版本管理

为什么需要它:PHP 是"解释执行"语言,但它的二进制、扩展、ini 配置三者是绑定的。装错版本、漏装扩展,后面写出来的代码在别人机器上跑不起来。

核心机制:

  • PHP 8.x 当前主流小版本为 8.1(安全维护末期)、8.2、8.3;新项目至少选 8.2。运行 php -v 第一行会输出 PHP 8.2.x (cli) ...,括号里的 cli 说明这是 CLI 二进制。
  • php -m 列出已编译进二进制或通过 ini 加载的全部扩展,如 pdo_mysql、mbstring、openssl、curl、gd、opcache。
  • php --ini 输出三个信息:Configuration File (php.ini) Path(默认搜索目录)、Loaded Configuration File(实际加载的 ini,显示 none 表示没加载任何 ini)、Scan for additional .ini files in(扩展目录)。
  • Windows 上把 php.ini-development 复制为 php.ini;Linux 发行版打包后通常已有 /etc/php/8.2/cli/php.ini 与 /etc/php/8.2/fpm/php.ini 两份独立文件。
  • 版本管理器( Linux 上 ondrej/php PPA、Windows 上手动解压多版本目录)允许一台机器并存 8.1/8.2/8.3,靠切换 PATH 或 FPM socket 区分。

最小可运行示例:

# 查看版本与已加载扩展
php -v
php -m | grep -E "pdo_mysql|mbstring|openssl|opcache"

# 查看实际加载的 ini 路径,区分 CLI 与 FPM
php --ini

# 写第一个脚本并运行
cat > hello.php <<'EOF'
<?php
echo "PHP 版本:" . PHP_VERSION . PHP_EOL;
echo "运行方式:" . (PHP_SAPI === 'cli' ? 'CLI' : PHP_SAPI) . PHP_EOL;
EOF
php hello.php

常见坑:

现象 原因 修法
Command not found: php 没把 PHP 目录加入 PATH 把 php 所在目录加入系统 PATH,重开终端
php -m 看不到 pdo_mysql 扩展未启用,或启用的是另一份 ini 在对应 ini 里写 extension=pdo_mysql,重启 FPM
Loaded Configuration File => (none) 没把 ini 放到默认搜索目录 复制 php.ini-development 到该目录并重命名为 php.ini

面试考法:常见问法是"你机器上 PHP 装在哪、扩展怎么查"。要答到"php -v 看 SAPI、php -m 看扩展、php --ini 看配置文件路径"三件套;追问"CLI 和 FPM 是不是同一个 PHP",答案是"通常是同一个二进制,但加载的 ini 不同、扩展也可能不同"。

5.2 CLI 与 Web 两种运行方式

为什么需要它:同一份 PHP 代码,在 CLI 下和在 FPM 下行为可能不同(超时、内存、SAPI、超全局变量)。不理解这一点,会把"CLI 跑通"直接当成"Web 跑通"。

核心机制:

  • PHP 有多种 SAPI(Server API):CLI(命令行)、FPM(Web 接入)、phpdbg、Embedded 等。PHP_SAPI 常量可在代码内判断当前 SAPI。
  • php file.php 直接执行;php -r "echo 1;" 执行单行;php -a 进入交互模式。
  • 内置服务器 php -S localhost:8000 -t public/ 适合本地开发,单线程,不能用于生产;它把 public/ 作为文档根,把请求路由到对应 .php 文件。
  • CLI 下默认 max_execution_time=0(不限时);FPM 下默认 max_execution_time=30 秒——这是"CLI 跑得完、Web 下 500"的典型原因。
  • CLI 下 $_SERVER['REQUEST_METHOD']、$_GET 等超全局为空;Web 下由 FPM 填充。

最小可运行示例:

# 用内置服务器跑一个目录
mkdir -p public
cat > public/index.php <<'EOF'
<?php
echo "SAPI = " . PHP_SAPI . PHP_EOL;
echo "请求方法 = " . ($_SERVER['REQUEST_METHOD'] ?? 'none') . PHP_EOL;
echo "查询参数 name = " . ($_GET['name'] ?? '(未传)') . PHP_EOL;
EOF
php -S localhost:8000 -t public/
# 另开一个终端
curl -i "http://localhost:8000/?name=ann"

常见坑:

现象 原因 修法
内置服务器下访问路由返回 404 该路径对应的 .php 文件不存在 检查文件路径与 URL 的对应关系
脚本 CLI 跑 60 秒不超时,FPM 下 30 秒就 500 FPM 的 max_execution_time 默认 30 在 ini 里调大,或在代码里 set_time_limit(0)
$_GET['x'] 在 CLI 下为空 CLI 没有 HTTP 请求 用 $argv/$argc 读命令行参数

面试考法:"PHP 有几种运行模式""内置服务器能不能上生产"。答到 SAPI 的概念,以及内置服务器单线程、无访问控制、不能扛并发,只用于本地开发。

5.3 php.ini 关键配置与两份 ini 的差异

为什么需要它:memory_limit、error_reporting、extension_dir 这些开关决定了脚本能用多少内存、报不报错、加载哪些扩展。CLI 与 FPM 各读一份,改一份不生效到另一份是本阶段最高频的坑。

核心机制:

  • 关键配置项与常用默认值:memory_limit = 128M(单脚本可用内存上限)、max_execution_time = 30(FPM 下脚本最长秒数)、display_errors = On(开发)/ Off(生产)、error_reporting = E_ALL、date.timezone = Asia/Shanghai、extension_dir = "ext"(Windows)或 /usr/lib/php/202xxx/(Linux)。
  • 扩展加载:extension=pdo_mysql(或 Windows 上 extension=php_pdo_mysql.dll);zend_extension=opcache(Zend 扩展用 zend_extension 加载)。
  • Linux Debian/Ubuntu 系:CLI ini 在 /etc/php/8.2/cli/php.ini,FPM ini 在 /etc/php/8.2/fpm/php.ini,两者独立;扩展目录分别是 /etc/php/8.2/cli/conf.d/ 与 /etc/php/8.2/fpm/conf.d/,软链共享但加载动作各自执行。
  • 生产建议:display_errors=Off、log_errors=On、error_log=/var/log/php/error.log;开发环境用 php.ini-development 档。

最小可运行示例:

; 在 FPM 加载的那份 php.ini 末尾追加,或在 conf.d/ 下新建 99-custom.ini
memory_limit = 256M
max_execution_time = 30
display_errors = Off
log_errors = On
error_log = /var/log/php/error.log
date.timezone = Asia/Shanghai
extension=pdo_mysql
extension=mbstring
zend_extension=opcache
# 修改后:CLI 直接生效,FPM 必须重启进程池
sudo systemctl restart php8.2-fpm
# 验证 FPM 读到的新值:写一个 phpinfo.php,浏览器访问
echo '<?php phpinfo();' > /var/www/html/phpinfo.php

常见坑:

现象 原因 修法
改完 ini 重启 FPM 仍不生效 改的是 CLI 的 ini,不是 FPM 的 确认 phpinfo() 页面里 "Loaded Configuration File" 路径,改那份
Fatal error: Allowed memory size of 134217728 bytes exhausted 单次脚本超过 128M 调大 memory_limit;同时排查是否内存泄漏
中文时间差 8 小时 date.timezone 未设置 设为 Asia/Shanghai 并重启 FPM
浏览器白屏无报错 display_errors=Off 且 log_errors 未配 打开 log_errors,看错误日志文件

面试考法:"memory_limit 是进程上限还是请求上限""生产环境 display_errors 开不开"。答到:是单个 PHP 请求/脚本的内存上限,不是 FPM 进程总内存;生产必须关 display_errors,错误写日志,避免把堆栈和路径泄露给用户。

5.4 Nginx + PHP-FPM 最小配置

为什么需要它:Nginx 不解析 PHP,它只负责静态文件与反向代理;PHP 代码由 FPM 通过 FastCGI 协议执行。三者(Nginx、FPM、文件路径)的对应关系配错,就出现 File not found. 或 502。

核心机制:

  • Nginx 的 server 块定义监听端口、域名、root(站点根目录)、index。
  • try_files $uri $uri/ /index.php?$query_string; 是把所有找不到的路径交给 index.php(框架路由常用)。
  • location ~ \.php$ 把所有 .php 请求转发给 FPM;fastcgi_pass 127.0.0.1:9000(TCP)或 fastcgi_pass unix:/run/php/php8.2-fpm.sock(Unix socket,更常用)。
  • 必须传的 FastCGI 参数:fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;——FPM 靠它找到要执行的 .php 文件,少了这行就报 File not found.。
  • FPM 侧 www.conf:listen = 127.0.0.1:9000 或 /run/php/php8.2-fpm.sock,user = www-data、group = www-data,pm = dynamic、pm.max_children = 5、pm.start_servers = 2、pm.min_spare_servers = 1、pm.max_spare_servers = 3(默认值)。

最小可运行示例:

# /etc/nginx/sites-available/hello.conf
server {
    listen 80;
    server_name hello.test;
    root /var/www/hello/public;
    index index.php index.html;

    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;
    }
}
# 校验并重载 Nginx
sudo nginx -t && sudo systemctl reload nginx
# 验证 FPM socket 存在
ls -l /run/php/php8.2-fpm.sock

常见坑:

现象 原因 修法
浏览器返回 File not found. SCRIPT_FILENAME 没传或路径拼错 确认 $document_root$fastcgi_script_name 指向真实存在的文件
502 Bad Gateway FPM 没启动、socket 路径不一致、端口被占用 systemctl status php8.2-fpm;对照 nginx 与 www.conf 的 listen 路径
No input file specified. root 指向的目录下不存在该文件 检查 root 是否真的是 PHP 文件所在目录
改完 Nginx 配置不生效 只 reload 了错误的配置目录 nginx -T 看实际加载的配置,确认软链到 sites-enabled

面试考法:"浏览器输入 URL 后,PHP 这边发生了什么""502 怎么排查"。答到完整链路:Nginx 匹配 location → 把 FastCGI 包发给 FPM → FPM 启动 worker 执行 PHP → 把结果通过 FastCGI 返回 Nginx → Nginx 返回给浏览器;502 说明 Nginx 拿不到 FPM 的响应,先查 FPM 进程与 socket。

5.5 HTTP 请求链路与 curl 定位问题

为什么需要它:线上问题九成先看状态码。分不清"Nginx 返回的 404"与"PHP 返回的 500",就会在错误的方向上排查。

核心机制:

  • 常见状态码:200 成功、301/302 重定向、403 无权限、404 资源不存在、500 PHP 代码错误、502 FPM 不可达、504 FPM 处理超时。
  • curl -i 同时打印响应头与响应体;curl -v 打印整条连接过程;curl -X POST -d "a=1" url 发 POST。
  • X-Powered-By: PHP/8.2.x 响应头说明响应确实由 PHP 产生;若没有该头,说明请求根本没到 PHP。
  • 请求方法:GET(查)、POST(增)、PUT(改全量)、PATCH(改局部)、DELETE(删)。

最小可运行示例:

# 看响应头
curl -i http://hello.test/

# 发 POST 并带 JSON
curl -i -X POST http://hello.test/api -H "Content-Type: application/json" -d '{"name":"ann"}'

# 看完整连接过程,定位是 Nginx 还是 FPM 出错
curl -v http://hello.test/ 2>&1 | grep -E "< HTTP|< X-Powered|Connected"

常见坑:

现象 原因 修法
curl 返回 404 但文件存在 Nginx 没把路由交给 index.php 检查 try_files 是否有 /index.php?$query_string
504 Gateway Time-out FPM 处理超时(见 5.3 的 max_execution_time) 看 PHP 错误日志,定位慢在哪段代码
响应里没有 X-Powered-By 请求没到 PHP,或 expose_php=Off 先确认 Nginx location 配置;再确认是 nginx 还是 PHP 返回

面试考法:"GET 和 POST 的区别""500 和 502 的区别"。答到语义区别,以及 500 是 PHP 代码异常、502 是 Nginx 连不上 FPM 这一关键边界。

5.6 Linux 常用命令与 Git 基本流程

为什么需要它:PHP 项目最终都跑在 Linux 服务器上。不会 ps、tail、systemctl,就没法在服务器上看 FPM 是否活着、日志写到哪。

核心机制:

  • 进程与服务:ps aux | grep php-fpm、systemctl status php8.2-fpm、systemctl restart php8.2-fpm、systemctl reload nginx。
  • 日志:tail -f /var/log/nginx/error.log、tail -f /var/log/php/error.log、journalctl -u php8.2-fpm -f。
  • 文件权限:chown -R www-data:www-data /var/www/hello(Nginx/FPM 进程用户要能读 PHP 文件、能写 storage 目录)。
  • Git:git init、git add .、git commit -m "msg"、git log --oneline、git status、git checkout -b feature/x。

最小可运行示例:

# 把本阶段的 hello 脚本纳入版本管理
cd /var/www/hello
git init
git add hello.php public/index.php
git commit -m "chore: 阶段0 hello 站点初始化"
git log --oneline
# 查看 FPM 进程数与监听
ps aux | grep php-fpm | head
tail -n 50 /var/log/php/error.log

常见坑:

现象 原因 修法
浏览器报 403 Forbidden root 目录或文件权限不给 www-data 读 chown -R www-data:www-data 或 chmod 755 目录
FPM 写 storage 报 Permission denied storage 目录属主不是 FPM 用户 把 storage/ 归到 www-data
git commit 提示请配置 user.name 首次用 Git 没配身份 git config --global user.name "..."、user.email

面试考法:不直接考,但阶段 6、阶段 7 的所有排障都建立在这几条命令上。答到"看进程、看日志、看权限"三步即可。

六、分层练习

6.1 复现型(照着做,跑通 + 能解释)

练习 要求 验收标准 预计耗时
装 PHP 8.2 并确认扩展 用包管理器或手动安装 php -v 输出 8.2,php -m 含 pdo_mysql/mbstring/opcache 2 小时
用内置服务器跑 hello php -S 启动并 curl 访问 curl -i 返回 200 与 SAPI 信息 0.5 小时
配 Nginx + FPM 站点 完成 server 块与 www.conf 对接 浏览器访问域名返回 200,无 502 2 小时
对比两份 ini 同时改 CLI 与 FPM 的 memory_limit 能说清哪份是哪份,phpinfo() 与 php --ini 路径对得上 1 小时
Git 提交 脚本至少两次提交 git log --oneline 有两条以上 0.5 小时

6.2 改造型(给出现成配置,改出正确行为)

练习 要求 验收标准 预计耗时
修一个 502 故意把 fastcgi_pass 指向不存在的 socket,再修回来 先复现 502,修复后恢复 200 0.5 小时
修一个 File not found. 故意漏掉 SCRIPT_FILENAME,再补回 复现报错 → 修复后访问成功 0.5 小时
把 display_errors 切到生产档 关闭 display_errors、打开 log_errors 浏览器白屏但错误日志有记录 0.5 小时
调 FPM 进程数 把 pm.max_children 从 5 改成 10 并重启 ps 看到的空闲进程数变化 0.5 小时

6.3 设计型(自己定方案)

练习 要求 验收标准 预计耗时
一份可复用的站点配置 写出一个新站点的 Nginx+FPM 配置模板 换个域名与 root 就能起一个新站点 2 小时
错误日志规范 把 PHP 错误日志、Nginx 日志、FPM 日志分目录归档 tail -f 三个日志能分别看到对应错误 1 小时
本地多版本 PHP 方案 在一台机器上并存 8.2 与 8.3 的 FPM 两个 socket 分别接不同站点 3 小时

七、排障表

现象 可能原因 排查步骤 解决办法
Command not found: php PHP 不在 PATH which php、echo $PATH 把 PHP bin 目录加入 PATH
php -m 看不到某扩展 扩展未在当前 ini 加载 php --ini 看 Loaded File,检查 extension= 行 在对应 ini 启用扩展,重启 FPM
浏览器 502 Bad Gateway FPM 未启动或 socket 路径不一致 systemctl status php8.2-fpm、对照 nginx 与 www.conf 的 listen 启动 FPM 或统一 socket 路径
File not found.(Nginx 返回) 缺 SCRIPT_FILENAME 或 root 错 nginx -T 看实际配置;确认 $document_root 指向真实目录 补 fastcgi_param SCRIPT_FILENAME
No input file specified. 文件在 root 下不存在 ls 实际文件路径,对比 URL 修正 root 或上传文件
504 Gateway Time-out FPM 处理慢或卡死 看 PHP 错误日志与慢日志 定位慢代码;调 request_terminate_timeout
浏览器白屏无报错 display_errors=Off 打开 log_errors 看日志 修错误,生产保持 display_errors Off
改完 ini 不生效 改的是 CLI 那份 ini 对比 phpinfo() 中 Loaded File 改 FPM 那份并重启 FPM

八、出口条件

全部勾选后进入 04.2 阶段 1 语言核心。

  • [ ] php -v、php -m、php --ini 三条命令输出能口述解释每一行含义
  • [ ] 能区分 CLI 与 FPM 各自加载的 ini 路径,改配置后知道要重启哪个进程
  • [ ] 能用 php -S 与 Nginx+FPM 两种方式跑通同一个 hello 页面
  • [ ] 能独立写出 Nginx server 块与 fastcgi_pass,不再出现 File not found.
  • [ ] 看到 500/502/504 能说出分别该去哪看日志
  • [ ] 脚本能提交到 Git 并留下至少两次提交记录
  • [ ] 排障表随机抽三个现象,5 分钟内给出排查路径

自测题(先自己想,再看要点):

  1. CLI 与 FPM 读的是同一份 php.ini 吗?
    • 要点:通常不是。Linux 发行版把 CLI 与 FPM 拆成两份独立 ini;Windows 上虽是同一份,但 SAPI 不同,行为仍有差异。
  2. File not found. 是谁返回的?缺哪一行配置?
    • 要点:是 FPM 返回的;缺 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;,FPM 不知道要执行哪个文件。
  3. max_execution_time 在 CLI 下默认多少?为什么?
    • 要点:CLI 下默认 0(不限时),因为 CLI 常跑长任务(脚本、队列);FPM 下默认 30 秒。
  4. 500 和 502 分别是谁产生的?
    • 要点:500 是 PHP 代码抛错后由 FPM 返回;502 是 Nginx 连不上 FPM(FPM 挂了、socket 错、端口占用)。
  5. php -m 看到 pdo_mysql,但 Web 页面 phpinfo() 里没有,说明什么?
    • 要点:CLI 与 FPM 的 ini 或扩展目录不同;去 FPM 的 ini 里补 extension=pdo_mysql。
  6. 为什么生产环境要把 display_errors 关掉?
    • 要点:避免把堆栈、文件路径、SQL 错误暴露给用户;错误应写到日志里由开发者查看。
  7. pm.max_children 默认值是多少?它控制什么?
    • 要点:默认 5;控制 FPM 同一时刻最多能有几个 worker 进程在处理请求,直接决定单机并发上限。