php文档

备案号:蜀ICP备2026035467号-3 | 网址:www.xservx.com

php文档·首页

PHP语言核心定位与生态价值

PHP(Hypertext Preprocessor),即“超文本预处理器”,是一种广泛使用的开源通用脚本语言,尤其适用于Web开发并可嵌入HTML中。自1995年由Rasmus Lerdorf首次发布以来,PHP已历经PHP/FI(1995)、PHP 3(1998)、PHP 4(2000)、PHP 5(2004)、PHP 7(2015)及PHP 8(2020)等重大演进阶段,逐步构建起成熟、稳定、高效的服务器端开发生态。

当前,全球超过77%的网站使用PHP作为后端语言(数据来源:W3Techs,2024),包括WordPress、Drupal、Joomla等主流CMS均基于PHP构建。国内如ThinkPHP、Laravel China社区、EaglePHP等开源项目持续活跃,推动PHP在微服务、API网关、SaaS平台、内容管理系统(CMS)、电商系统(如Ecshop、PrestaShop)、企业OA/ERP系统等领域保持强劲生命力。

PHP 8引入的JIT编译器虽未显著提升纯CPU运算性能,但在复杂Web业务场景中通过减少Zend Engine解释开销,实现了平均10%~15%的吞吐量提升;同时新增的联合类型(Union Types)、构造器属性提升(Constructor Property Promotion)、匹配表达式(Match Expression)、命名参数(Named Arguments)等语法特性,大幅提升了代码表达力与可维护性。

值得注意的是,PHP并非传统意义上的“面向对象语言”,而是一种多范式脚本语言:支持面向过程、面向对象(含接口、抽象类、trait、匿名类、闭包)、函数式编程(高阶函数、匿名函数、箭头函数)及事件驱动模型。其执行模型采用“请求-响应”同步阻塞模式,每个HTTP请求独立启动一个PHP进程/线程(取决于SAPI),这虽带来资源开销,但也确保了请求隔离性与安全性。

PHP文档内容体系与知识结构

本平台提供结构化PHP技术文档体系,覆盖以下维度:

  • 基础语法层:变量作用域、数据类型(标量、复合、特殊)、运算符、控制结构(if/else、switch、循环、goto)、函数定义与调用、类与对象(OOP)、命名空间、错误与异常处理、魔术方法、trait复用机制。
  • 内置扩展层:JSON(encode/decode)、XML(SimpleXML、DOM)、PDO(数据库抽象层)、MySQLi、cURL(HTTP客户端)、Session与Cookie管理、Filesystem(文件操作)、Multibyte String(mbstring)、Intl(国际化)、Filter(输入过滤)、GD与Imagick(图像处理)、 Phar(归档打包)、Phar流包装器。
  • 运行时环境层:PHP配置(php.ini)、SAPI类型(CLI、CGI、FPM、Apache模块、IIS)、OPcache缓存机制、APCu用户缓存、OPcache JIT配置、内存管理(引用计数、垃圾回收GC)、OPcache与OPline缓存优化策略。
  • 开发工具层:Composer依赖管理、PSR标准(PSR-1~PSR-18)、Xdebug调试器、PHPStan静态分析、PHP-CS-Fixer代码规范、PHPUnit单元测试、Docker容器化部署、CI/CD集成(GitHub Actions、GitLab CI)。
  • 安全工程层:输入验证(filter_var、正则校验)、输出转义(htmlspecialchars、htmlentities)、SQL注入防护(预处理语句、参数绑定)、XSS防护(CSP头、Content-Type)、CSRF防护(Token机制)、文件上传安全(MIME检测、扩展名白名单)、会话安全(session.cookie_httponly、session.use_strict_mode)、日志审计与入侵检测。
  • 性能优化层:代码级优化(避免全局变量、使用本地变量、减少函数调用)、OPcache启用与调优、APCu缓存热点数据、数据库连接池与持久连接、异步非阻塞(ReactPHP、Swoole)、协程编程(Swoole协程、Amp)、CDN静态资源分离、HTTP/2多路复用、Gzip/Brotli压缩、HTTP缓存控制(ETag、Cache-Control、Vary)。
  • 框架生态层:Laravel(Eloquent ORM、Blade模板、队列系统)、Symfony(组件化架构、Dependency Injection)、ThinkPHP(MVC、路由自动注册)、Yii(高性能、GII代码生成)、CakePHP(约定优于配置)、CodeIgniter(轻量级、快速开发)、Laminas(原ZF2,企业级框架)。
  • 版本迁移层:PHP 5→7迁移(性能提升、类型系统增强)、PHP 7→8迁移(JIT、命名空间改进、属性Attribute)、废弃特性识别(ereg扩展移除、魔术引号彻底废弃)、兼容性检查工具(PHPBC、Rector)、CI/CD自动化测试策略。

开发者常见困惑与文档设计初衷

许多开发者在实际工作中面临以下典型问题:

  • “为什么我用了mysqli_real_escape_string仍被SQL注入?”——因未正确使用预处理语句,或在拼接SQL时遗漏引号包裹。
  • “为什么htmlspecialchars没有生效?”——因未指定编码参数(如ENT_QUOTES, 'UTF-8'),或输入已含HTML实体(需先decode)。
  • “为什么OPcache开启后代码不更新?”——因未清空缓存(php-fpm reload或opcache_reset()),或开发模式未启用opcache.validate_timestamps。
  • “为什么composer update卡在安装ext-*扩展?”——因未在php.ini中启用对应扩展(如extension=openssl),或composer.json中require冲突。
  • “为什么session在Nginx下无法跨子域共享?”——因session.cookie_domain未正确配置(如'.example.com')。

本文档旨在通过权威解释、标准示例与反例对比,帮助开发者建立正确认知,避免“复制粘贴式开发”带来的安全隐患与维护困境。我们强调:理解底层原理比记忆API更重要,掌握调试方法比依赖IDE提示更可靠。

语法核心:从变量到命名空间

变量与作用域深度解析

PHP变量以$开头,支持动态类型,但不支持引用类型声明(除&符号外)。变量作用域分为:

  • 局部作用域:函数内定义的变量仅在函数内可见。
  • 全局作用域:脚本主体中定义的变量,在函数内不可见,需用global关键字引入。
  • 超全局变量:$_GET、$_POST、$_SESSION、$_COOKIE、$_SERVER、$_FILES、$_ENV、$_REQUEST、$GLOBALS——无需global即可在任何作用域访问。

注意:$GLOBALS是唯一可在函数内直接修改全局变量的方式(通过引用),而global仅创建别名。例如:

<?php $a = 10; function test() { global $a; $a = 20; // 修改全局$a echo $a; // 输出20 } test(); echo $a; // 输出20(全局已被修改) function test2() { $GLOBALS['b'] = 30; // 直接操作全局变量 } test2(); echo $b; // 输出30 ?>

在PHP 7.4+中,支持类型声明(Scalar Type Declarations):int、float、string、bool、callable、array、object、iterable、mixed(PHP 8.0+)、never(PHP 8.1+)。启用strict_types=1后,类型强制转换仅在标量类型下生效,提升类型安全性。

控制结构与表达式演进

PHP支持标准if/else、switch(支持字符串与表达式匹配)、循环(for、foreach、while、do-while)。PHP 7引入的??(null合并运算符)与PHP 8的match表达式极大简化了条件逻辑:

<?php // PHP 7: null合并 $name = $_GET['name'] ?? 'Guest'; // PHP 8: match表达式(返回值、短路求值、严格比较) $status = match($code) { 200 => 'OK', 404 => 'Not Found', 500 => 'Server Error', default => throw new Exception('Unknown code'), }; // 对比switch(需break,否则fall-through) switch($code) { case 200: $status = 'OK'; break; case 404: $status = 'Not Found'; break; default: throw new Exception('Unknown code'); } ?>

match表达式要求所有分支返回相同类型,否则抛出TypeError;支持多条件匹配(用逗号分隔)、守卫条件(箭头后加if)、箭头函数作为值(PHP 7.4+)。例如:

<?php $result = match(true) { $score >= 90 => 'A', $score >= 80 => 'B', $score >= 70 => 'C', default => 'D', }; ?>

类与对象:OOP核心机制

PHP的OOP支持封装、继承、多态、抽象类、接口、trait、final关键字、访问控制(public/protected/private)、魔术方法(__construct、__destruct、__get、__set、__call、__toString、__invoke、__clone、__sleep、__wakeup、__set_state、__debugInfo)。

构造器属性提升(PHP 8.0+)简化了属性声明与初始化:

<?php class User { public function __construct( private string $name, private int $age, private ?string $email = null ) {} } $user = new User('Alice', 25, 'alice@example.com'); echo $user->name; // 无法直接访问(private) ?>

需通过getter方法或使用#[\AllowDynamicProperties]属性(PHP 8.2+)动态添加属性(不推荐生产环境使用)。

Trait冲突解决:当多个trait存在同名方法时,需用insteadof指定使用哪个,或用as重命名:

<?php trait A { public function foo() { echo 'A'; } } trait B { public function foo() { echo 'B'; } } class C { use A, B { B::foo insteadof A; // 使用B的foo A::foo as fooA; // 将A的foo重命名为fooA } } $c = new C(); $c->foo(); // 输出B $c->fooA(); // 输出A ?>

函数与扩展:内置API实用指南

字符串处理:mbstring与iconv对比

PHP内置函数如strlen、strpos、substr仅处理字节,对UTF-8多字节字符易出错。应使用mbstring扩展函数:

<?php $str = '中文测试'; echo strlen($str); // 输出6(3个汉字×2字节) echo mb_strlen($str); // 输出4(正确计数字符数) echo strpos($str, '中'); // 可能返回0或false(字节偏移) echo mb_strpos($str, '中'); // 返回0(字符偏移) ?>

注意:mbstring需在php.ini中启用extension=mbstring,并设置default_charset = "UTF-8"。推荐使用mb_convert_encoding($str, 'UTF-8', 'auto')统一编码。

JSON操作:从基础到高级

JSON编码(encode)与解码(decode)需处理以下常见问题:

  • 中文转义:默认encode会将中文转为Unicode(如\u4e2d\u6587)。使用JSON_UNESCAPED_UNICODE(PHP 5.4+)保留原字符:
<?php $data = ['msg' => '你好']; echo json_encode($data); // {"msg":"\u4f60\u597d"} echo json_encode($data, JSON_UNESCAPED_UNICODE); // {"msg":"你好"} ?>
  • 深度限制:JSON_THROW_ON_ERROR(PHP 7.3+)可抛出JsonException,避免silent失败:
<?php try { $obj = json_decode('{"a":1}', true, 512, JSON_THROW_ON_ERROR); } catch (JsonException $e) { error_log($e->getMessage()); } ?>
  • 浮点数精度:PHP 8.1+支持JSON_PRESERVE_ZERO_FRACTION保留小数点后零(如1.0→1.0而非1)。

数据库操作:PDO与MySQLi最佳实践

预处理语句防止SQL注入:

<?php // PDO方式 $pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'root', ''); $stmt = $pdo->prepare('SELECT * FROM users WHERE email = :email AND status = :status'); $stmt->execute(['email' => $_GET['email'], 'status' => 1]); $user = $stmt->fetch(PDO::FETCH_ASSOC); // MySQLi方式(面向对象) $mysqli = new mysqli('localhost', 'root', '', 'test'); $stmt = $mysqli->prepare('SELECT * FROM users WHERE email = ? AND status = ?'); $stmt->bind_param('si', $email, $status); $email = $_GET['email']; $status = 1; $stmt->execute(); $user = $stmt->get_result()->fetch_assoc(); ?>

字符集安全:连接后立即执行SET NAMES 'utf8mb4'或在DSN中指定charset=utf8mb4,避免乱码与注入风险。

安全开发:常见漏洞与防护策略

输入验证与输出转义

验证应优先使用filter_var系列函数:

<?php $email = filter_input(INPUT_GET, 'email', FILTER_VALIDATE_EMAIL); $age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT, ['options' => ['min_range' => 1, 'max_range' => 120]]); $url = filter_input(INPUT_GET, 'url', FILTER_VALIDATE_URL); ?>

输出转义需根据上下文选择函数:

  • HTML内容:htmlspecialchars($str, ENT_QUOTES, 'UTF-8')
  • HTML属性:htmlspecialchars($str, ENT_QUOTES | ENT_HTML401, 'UTF-8') + 双引号包裹属性
  • JavaScript:json_encode($str, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP)
  • URL参数:urlencode($str)
  • SQL:仅通过预处理语句,不使用addslashes!

会话安全配置

在php.ini中启用以下配置:

session.cookie_httponly = 1 session.cookie_secure = 1 session.use_strict_mode = 1 session.cookie_samesite = "Strict" 或 "Lax" session.sid_length = 48 session.sid_bits_per_character = 6

代码中动态设置(需在session_start前):

<?php session_set_cookie_params([ 'lifetime' => 0, 'path' => '/', 'domain' => '.example.com', 'secure' => true, 'httponly' => true, 'samesite' => 'Lax', ]); session_start(); ?>

定期更新Session ID(登录后、权限变更时):

session_regenerate_id(true);

文件上传安全

必须同时校验以下四点:

  1. 扩展名白名单(如jpg、png、gif)
  2. MIME类型检测($_FILES['file']['type']不信任!应使用finfo_file())
  3. 文件内容校验(如图片头检测)
  4. 存储路径隔离(禁止执行权限)
<?php $allowedExts = ['jpg', 'jpeg', 'png', 'gif']; $ext = strtolower(pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION)); if (!in_array($ext, $allowedExts)) { die('扩展名不允许'); } $finfo = finfo_open(FILEINFO_MIME_TYPE); $mimeType = finfo_file($finfo, $_FILES['file']['tmp_name']); $allowedTypes = ['image/jpeg', 'image/png', 'image/gif']; if (!in_array($mimeType, $allowedTypes)) { die('MIME类型不匹配'); } // 移动到非Web目录(如/storage/uploads/) move_uploaded_file($_FILES['file']['tmp_name'], '/data/uploads/' . uniqid() . '.' . $ext); ?>

数据库操作:从基础到进阶

连接池与持久连接

MySQLi支持持久连接(pconnect),避免频繁建立TCP连接,适用于高并发短请求场景。但需注意:

  • 持久连接在PHP-FPM下由Master进程管理,可能积累过多连接
  • 需在mysqlnd驱动下启用(php.ini中mysqlnd.net_charset = 'utf8mb4')
  • 事务未提交或结果集未清空时连接会被占用

推荐使用连接池中间件(如ProxySQL)或Swoole协程连接池管理。

慢查询日志与索引优化

慢查询日志配置(my.cnf):

slow_query_log = 1 slow_query_log_file = /var/log/mysql/slow.log long_query_time = 1 log_queries_not_using_indexes = 1

索引使用原则:

  • 高频查询字段建索引(WHERE、JOIN、ORDER BY、GROUP BY)
  • 避免过度索引(影响写性能)
  • 复合索引遵循最左前缀原则(index(a,b,c)可匹配a、a+b、a+b+c)
  • 使用EXPLAIN分析执行计划
EXPLAIN SELECT * FROM users WHERE email = 'test@example.com' AND status = 1;

若type为ALL(全表扫描),需添加索引;若key为NULL,表示未使用索引。

性能优化:全栈调优策略

OPcache深度配置

在php.ini中启用OPcache并调优参数:

[opcache] opcache.enable=1 opcache.enable_cli=0 opcache.memory_consumption=256 opcache.interned_strings_buffer=64 opcache.max_accelerated_files=100000 opcache.validate_timestamps=0 opcache.save_comments=0 opcache.fast_shutdown=1

生产环境建议关闭时间戳校验(validate_timestamps=0),通过部署脚本手动刷新缓存(opcache_reset()或重启php-fpm)。

APCu缓存热点数据

缓存数据库查询结果、配置信息、模板编译结果:

<?php $cacheKey = 'user_profile_' . $userId; if (($data = apcu_fetch($cacheKey)) === false) { $data = $db->fetch('SELECT * FROM users WHERE id = ?', [$userId]); apcu_store($cacheKey, $data, 3600); // 缓存1小时 } print_r($data); ?>

注意:APCu内存为共享内存,多进程间共享,但需合理设置apc.shm_size(如128M)。

HTTP缓存控制

在响应头中设置:

Cache-Control: public, max-age=86400, s-maxage=86400 ETag: "abc123" Last-Modified: Wed, 21 Oct 2015 07:28:00 GMT Vary: Accept-Encoding

前端CDN可基于ETag和If-None-Match实现条件请求,减少带宽消耗。

调试技巧:从基础到高级

Xdebug配置与使用

在php.ini中启用Xdebug:

[xdebug] xdebug.mode=debug,develop xdebug.start_with_request=trigger xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.log_level=0

配合IDE(如PHPStorm)设置断点,通过浏览器插件(Xdebug Helper)触发调试会话。

日志审计与错误捕获

自定义错误处理器:

<?php set_error_handler(function($errno, $errstr, $errfile, $errline) { error_log(sprintf("[%s] %s in %s:%d\n", date('Y-m-d H:i:s'), $errstr, $errfile, $errline), 3, '/var/log/php_errors.log'); return false; // 继续默认处理 }); set_exception_handler(function($e) { error_log(sprintf("[%s] Uncaught exception: %s in %s:%d\n", date('Y-m-d H:i:s'), $e->getMessage(), $e->getFile(), $e->getLine()), 3, '/var/log/php_exceptions.log'); http_response_code(500); echo 'Server Error'; }); ?>

建议在生产环境关闭display_errors,启用log_errors。

框架生态:主流框架对比与选型

Laravel核心特性

  • Eloquent ORM:支持关联关系(HasOne、HasMany、BelongsTo、BelongsToMany)、查询构造器(where、join、orderBy)、访问器/修改器(getAttribute/setAttribute)。
  • Blade模板:支持模板继承、组件(@component)、插槽(@slot)、条件编译(@if、@foreach)。
  • 队列系统:支持Redis、Database、Beanstalkd驱动,异步处理邮件发送、图片处理。
  • 事件与监听器:解耦业务逻辑,如订单创建后触发通知事件。
// app/Models/User.php class User extends Model { protected $fillable = ['name', 'email']; public function posts() { return $this->hasMany(Post::class); } } // 控制器中 $user = User::with('posts')->find($id); return view('user.show', compact('user'));

ThinkPHP快速开发优势

  • 自动路由:支持URL路由自动注册(模块/控制器/方法)。
  • 数据库操作:链式调用(where、order、limit)与原生SQL混合使用。
  • 验证器:独立验证类,支持场景(scene)与规则(rule)。
// app/controller/User.php class User extends Controller { public function profile($id) { $user = Db::name('user')->find($id); return $this->fetch('', ['user' => $user]); } }

版本迁移:平滑升级策略

PHP 7→8迁移检查清单

  1. 检查扩展兼容性(如MongoDB扩展已废弃,需改用mongodb/mongodb库)
  2. 替换已移除函数(ereg_* → preg_*;mcrypt_* → openssl_*)
  3. 处理类型变更(如count()对非数组返回1而非0)
  4. 更新框架版本(Laravel 6+支持PHP 7.3+,Laravel 8+需PHP 7.3+)
  5. 使用Rector工具自动重构代码
// Rector示例配置 use Rector\Core\Configuration\Option; use Rector\Php80\Rector\FuncCall\FuncGetArgsToVariadicParamRector; use Rector\Php80\Rector\FunctionLike\UnionTypesRector; return static function (ContainerConfigurator $containerConfigurator): void { $containerConfigurator->import(__DIR__ . '/vendor/rector/rector/config/php80.php'); };

CI/CD自动化测试

在GitHub Actions中添加PHP版本矩阵测试:

name: PHP CI on: [push] jobs: test: runs-on: ubuntu-latest strategy: matrix: php: ['7.4', '8.0', '8.1', '8.2'] steps: - uses: actions/checkout@v3 - uses: shivammathur/setup-php@v2 with: php-version: ${{ matrix.php }} - run: composer install - run: phpunit

FAQ:高频问题解答

为什么我的session在Nginx下失效?

检查以下三点:

  1. nginx.conf中fastcgi_param PHP_VALUE "session.save_path='/var/lib/php/sessions';"
  2. PHP-FPM进程用户(如www-data)对session目录有读写权限
  3. php.ini中session.cookie_domain与域名匹配(如'.example.com')

PHP如何处理并发请求?

PHP本身是单线程同步模型,但可通过以下方式提升并发能力:

  • 增加PHP-FPM子进程数(pm.max_children)
  • 启用OPcache减少编译开销
  • 使用Swoole协程实现异步非阻塞
  • 引入Redis队列削峰填谷

PHP 8的JIT真能提升性能吗?

JIT主要优化CPU密集型代码(如数学计算、加密算法),对I/O密集型Web应用提升有限(约5%~10%)。建议启用OPcache而非依赖JIT。可通过phpinfo()查看JIT状态(JIT=on/off)。