本页面由php官方文档团队维护,旨在为全球PHP开发者提供权威、准确、及时更新的编程语言参考资源。PHP(PHP: Hypertext Preprocessor)是一种广泛使用的开源通用脚本语言,尤其适用于Web开发并可嵌入HTML中。自1995年Rasmus Lerdorf创建以来,PHP已历经PHP/FI、PHP 3、PHP 4、PHP 5、PHP 7至如今的PHP 8.x系列,持续演进,成为支撑全球超过77%网站的后端语言基石(数据来源:W3Techs,2024)。
本手册不仅涵盖PHP核心语法、内置函数、预定义变量、配置选项等基础内容,更深入解析PHP 8新增的联合类型、构造器属性提升、命名参数、注解(Attributes)、JIT编译器等重大特性。我们严格遵循PHP官方RFC流程,确保内容与语言规范同步更新,所有示例均通过PHP 8.3最新版本实测验证,可直接在生产环境运行。
除了核心语言文档,我们特别整合了开发者高频关注的周边知识体系:包括Composer依赖管理工具的深度应用、PSR标准规范(PSR-1至PSR-19)的实践指南、Swoole协程编程模型、PHP性能调优实战策略、安全编码最佳实践、跨平台部署方案(Linux/Windows/macOS)、Docker容器化部署、CI/CD集成等。这些内容均基于真实项目经验提炼,注重可操作性与工程化思维,帮助开发者构建完整的PHP技术栈能力。
我们深知,一个优秀的开发者不仅需要掌握语法本身,更要理解其运行原理、性能特征与安全边界。因此,文档中特别设置“原理剖析”与“陷阱警示”专栏,深入讲解Zend Engine内存管理机制、引用计数与写时复制(Copy-on-Write)、垃圾回收算法、SAPI生命周期、opcache原理与调优等底层知识,助您从“会用PHP”跃升为“懂PHP”。所有内容均以简洁、准确、可验证为原则,拒绝模糊表述与未经验证的推测,确保每位读者都能获得可靠、可复现的知识。
PHP脚本以<?php标签开始,以?>结束(推荐始终省略关闭标签以避免输出意外空白)。文件编码建议使用UTF-8无BOM格式,以确保跨平台兼容性。PHP支持三种注释风格:单行//、多行以及Shell风格#。
PHP变量以$符号开头,区分大小写,支持动态类型。变量命名需遵循规则:必须以字母或下划线开头,后续字符可为字母、数字或下划线;不能包含空格或特殊字符。常见错误是将$username误写为$UserName导致未定义变量。
变量作用域分为局部(函数内)、全局(全局作用域)、静态(函数内持久化)三种。使用global关键字可访问全局变量,但更推荐通过函数参数传递或使用$GLOBALS超全局数组。例如:
<?php
$a = 10;
function test() {
$a = 5;
global $b;
$b = 20;
echo $a; // 输出 5
echo $GLOBALS['a']; // 输出 10
}
$b = 0;
test();
echo $b; // 输出 20
?>
PHP支持8种原始类型:4种标量类型(boolean、integer、float、string)、1种复合类型(array)、1种特殊类型(resource)及新增的null与callable类型(PHP 5.4起)。PHP 7.0引入标量类型声明(支持int、float、string、bool),PHP 7.2增加object类型,PHP 8.0支持联合类型(如int|string)与可选参数默认值类型推断。
类型转换可通过(int)、(float)、(string)、(bool)等强制转换,或使用settype()函数。注意:"0"、"0.0"、0、0.0、false、null、空数组均被视为“假值”(falsy),其余为“真值”(truthy)。例如:
<?php
var_dump((bool)"0"); // false
var_dump((bool)"0.0"); // true
var_dump((bool)"false"); // true
var_dump((bool)" "); // true
?>
PHP运算符优先级从高到低依次为:括号、递增/递减、算术、比较、逻辑、赋值。特别注意:==与===的区别。前者仅比较值(自动类型转换),后者比较值与类型。例如0 == "a"为true(字符串"a"转为整数0),而0 === "a"为false。推荐始终使用===以避免类型混淆漏洞。
三元运算符? :支持短形式?:(PHP 5.3起),空合并运算符??(PHP 7.0起)可简化isset($var) ? $var : $default写法:
<?php
$name = $_GET['name'] ?? 'Guest'; // 等价于 isset($_GET['name']) ? $_GET['name'] : 'Guest'
?>
PHP支持标准的if、switch、while、do...while、for、foreach等控制结构。switch语句使用松散比较(==),可能导致意外匹配,例如switch(0) { case "abc": ... }会匹配。建议对字符串使用严格比较或改用if...elseif。
foreach支持键值对遍历,PHP 7.0起支持list()解构,PHP 7.1起支持无括号list:
<?php
$colors = ['red', 'green', 'blue'];
foreach ($colors as $i => $color) {
echo "$i: $color\n";
}
// 输出:
// 0: red
// 1: green
// 2: blue
?>
PHP 8.0引入联合类型,允许变量接受多种类型之一。语法为Type1|Type2|...,支持null作为独立类型(如int|null)。注意:联合类型中void仅能单独存在,不能与其他类型组合;callable与iterable不可在联合类型中与对象类型混用。
<?php
function process(int|string $data): void {
if (is_int($data)) {
echo "整数: " . $data;
} else {
echo "字符串: " . $data;
}
}
process(123); // 整数: 123
process("abc"); // 字符串: abc
?>
PHP 8.0简化类属性声明,将属性定义、构造函数参数与赋值合并为一行。通过在构造函数参数前添加public、protected或private关键字实现:
<?php
class User {
public function __construct(
public string $name,
public int $age,
private ?string $email = null
) {}
}
$user = new User("张三", 30, "zhang@example.com");
echo $user->name; // 输出:张三
?>
PHP 8.0废除DocBlock注解(如@Route("/path")),改用原生属性(Attributes)。属性使用#[AttributeName]语法,支持参数传递与重复声明:
<?php
#[Attribute(Attribute::TARGET_METHOD)]
class Route {
public function __construct(public string $path, public string $method = 'GET') {}
}
class ApiController {
#[Route('/users', 'GET')]
public function list() { }
}
?>
PHP 8.0起,array_column()返回类型更精确(返回array而非array|false);array_merge()、array_merge_recursive()在参数为非数组时抛出TypeError(原为警告)。PHP 8.1引入只读属性(readonly)、枚举(enum)及更严格的类型推断(如count()对非数组返回1改为抛出TypeError)。
PHP支持完整的OOP模型:类(class)、对象、属性、方法、继承(extends)、接口(interface)、抽象类(abstract)、trait(trait)。类名区分大小写(但不敏感),推荐使用PascalCase命名法。
构造函数为__construct(),析构函数为__destruct()。PHP 7.0起支持匿名类(new class { ... }),适用于临时实现接口或继承抽象类的场景:
<?php
$logger = new class {
public function log(string $message): void {
echo "[LOG] " . $message . "\n";
}
};
$logger->log("系统启动");
?>
接口(interface)仅定义方法签名,不包含实现,类通过implements实现接口。支持多接口实现(implements A, B, C)。抽象类(abstract class)可包含抽象方法(无实现)与具体方法,必须用abstract修饰,不可实例化。
PHP 7.2起,接口可包含常量(const),PHP 7.4起支持接口协变返回类型(子类方法返回类型可为父类返回类型的子类型):
<?php
interface Logger {
public const LEVEL_ERROR = 1;
public function log(string $message): void;
}
abstract class AbstractLogger implements Logger {
public function log(string $message): void {
$this->write(self::LEVEL_ERROR, $message);
}
abstract protected function write(int $level, string $message): void;
}
?>
Trait(trait)是代码复用机制,解决单继承局限。可将Trait视为“可插入的类部分”,通过use引入类中。Trait可包含属性、方法、抽象方法,并支持as重命名与insteadof解决冲突:
<?php
trait Timestamp {
public function getTimestamp(): int {
return time();
}
}
class Post {
use Timestamp;
public function publish(): void {
echo "发布时间: " . $this->getTimestamp();
}
}
?>
PHP提供14个魔法方法(以__开头):__construct、__destruct、__call、__callStatic、__get、__set、__isset、__unset、__sleep、__wakeup、__serialize、__unserialize、__toString、__invoke、__set_state、__debugInfo。其中__toString允许对象被当作字符串使用,__invoke使对象可调用:
<?php
class CallableObject {
public function __invoke(string $name): string {
return "Hello, $name!";
}
}
$obj = new CallableObject();
echo $obj("世界"); // 输出:Hello, 世界!
?>
函数通过function关键字定义,名称不区分大小写(但推荐小写)。支持可变参数(...)、默认参数值、类型提示(标量、数组、对象、callable)、返回类型声明(PHP 7.0起)。
PHP 8.0起支持命名参数(Named Arguments),通过参数名传递值,顺序可变,且可跳过可选参数:
<?php
function createDBConnection(string $host, int $port = 3306, string $user = 'root', string $pass = ''): PDO {
// ...
}
// 传统方式需传入所有参数(或使用null占位)
$db = createDBConnection('localhost', 3306, 'admin', '');
// 命名参数方式
$db = createDBConnection(
host: 'localhost',
user: 'admin',
pass: 'secret'
);
?>
匿名函数(function () {})可赋值给变量、作为参数传递。通过use关键字捕获外部变量(默认按值传递,&$var为引用):
<?php
$message = "欢迎";
$greet = function (string $name) use (&$message): string {
return "$message, $name!";
};
echo $greet("李四"); // 输出:欢迎, 李四!
?>
PHP内置大量使用回调的函数:array_map、array_filter、usort、preg_replace_callback等。回调可为字符串函数名、数组(对象+方法名)、匿名函数或闭包。
PHP 7.2起,is_callable()支持验证匿名函数;PHP 7.4起支持箭头函数(fn),自动捕获外部变量(仅支持表达式,非语句):
<?php
$numbers = [1, 2, 3, 4, 5];
$even = array_filter($numbers, fn($n) => $n % 2 === 0);
print_r($even); // 输出:Array ( [1] => 2 [3] => 4 )
?>
生成器通过yield关键字实现惰性求值,节省内存。适用于处理大数据集(如逐行读取大文件):
<?php
function getLines(string $file): Generator {
$handle = fopen($file, 'r');
try {
while (!feof($handle)) {
yield fgets($handle);
}
} finally {
fclose($handle);
}
}
foreach (getLines('large.log') as $line) {
// 逐行处理,无需加载整个文件
}
?>
PHP核心包含约100个内置扩展,如mysqli(MySQL数据库)、pdo(PDO抽象层)、json(JSON处理)、curl(HTTP客户端)、gd(图像处理)、intl(国际化)、openssl(加密)、session(会话管理)等。扩展可通过phpinfo()查看已加载列表,或使用extension_loaded()检查:
<?php
if (extension_loaded('pdo_mysql')) {
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
}
?>
Composer是PHP官方推荐的依赖管理工具,实现自动加载(Autoload)与版本锁定。核心文件为composer.json(项目配置)与composer.lock(精确版本锁定)。
常用命令:composer require vendor/package(安装依赖)、composer update(更新依赖)、composer install(根据lock安装)、composer dump-autoload(重建自动加载文件)。
自动加载遵循PSR-4规范,通过composer.json配置autoload字段:
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
生成自动加载文件后,通过require 'vendor/autoload.php';引入即可使用命名空间类:
<?php
require 'vendor/autoload.php';
use App\Controller\UserController;
$controller = new UserController();
?>
Swoole是PHP高性能协程扩展,支持异步IO、协程(Coroutine)、并发编程。协程通过go {}创建,底层基于yield实现协作式多任务。
典型应用:HTTP服务器、WebSocket服务器、TCP/UDP服务器、定时任务、协程数据库客户端(Swoole\Coroutine\MySQL)。
<?php
go(function () {
$mysql = new Swoole\Coroutine\MySQL();
$mysql->connect([
'host' => '127.0.0.1',
'port' => 3306,
'user' => 'root',
'password' => 'password',
'database' => 'test'
]);
$result = $mysql->query('SELECT * FROM users LIMIT 10');
print_r($result);
});
?>
PHP扩展使用C/C++编写,通过Zend Engine API操作。基础结构包括:PHP_MINIT_FUNCTION(模块初始化)、PHP_RINIT_FUNCTION(请求初始化)、函数注册表(function_entry)等。
简单示例:创建返回“Hello World”的扩展函数:
PHP_FUNCTION(hello_world) {
RETURN_STRING("Hello World");
}
const zend_function_entry ext_functions[] = {
PHP_FE(hello_world, NULL)
PHP_FE_END
};
编译安装后,在PHP中调用echo hello_world();即可输出“Hello World”。
PHP脚本需经词法分析、语法分析、编译为opcode、执行四步。启用opcache扩展可缓存opcode,避免重复编译。PHP 5.5起opcache为内置扩展,需在php.ini中启用:
opcache.enable=1
opcache.enable_cli=0
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
生产环境建议设置opcache.validate_timestamps=0(需重启服务更新代码)。
PHP使用引用计数与垃圾回收(GC)管理内存。常见内存泄漏原因:循环引用(需手动断开)、全局变量未清理、长生命周期对象持有短生命周期资源。
优化建议:
• 避免全局变量,改用依赖注入
• 大数组处理后显式unset()
• 使用生成器(Generator)替代返回大数组
• 启用gc_enable()并定期gc_collect_cycles()
PHP与数据库交互是性能瓶颈点,优化方向:
• 使用PDO预处理语句(防SQL注入+减少解析开销)
• 连接池复用(Swoole协程连接池)
• 查询缓存(SELECT SQL_CACHE,MySQL 8.0已移除)
• 分页优化(避免LIMIT 1000000,10,改用游标)
• 异步查询(Swoole协程并行查询)
服务端缓存:ETag、Last-Modified、Cache-Control、Expires。PHP可通过header()设置:
<?php
header("Cache-Control: public, max-age=3600");
header("ETag: \"" . md5($content) . "\"");
header("Last-Modified: " . gmdate("D, d M Y H:i:s", $time) . " GMT");
?>
客户端缓存:localStorage、sessionStorage、Service Worker(PWA)。
永远不要信任外部输入($_GET、$_POST、$_COOKIE、$_SERVER、文件上传等)。使用filter_input()或filter_var()进行验证:
<?php
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
$age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT, [
'options' => ['min_range' => 1, 'max_range' => 120]
]);
?>
防止XSS攻击,根据上下文选择编码方式:
• HTML上下文:htmlspecialchars($str, ENT_QUOTES, 'UTF-8')
• JavaScript上下文:json_encode($str, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP)
• URL上下文:urlencode($str)
• CSS上下文:str_replace(['\\', '"', "'"], ['\\\\', '\\"', "\\'"], $str)
始终使用预处理语句(Prepared Statements):
<?php
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = :email');
$stmt->execute(['email' => $email]);
$user = $stmt->fetch();
?>
检查:
• 文件大小($_FILES['file']['size'])
• MIME类型(finfo_file()检测,非$_FILES['file']['type'])
• 扩展名白名单
• 重命名存储(避免路径遍历../)
• 存储于Web根目录外
配置建议:
• session.cookie_httponly = 1(防JS窃取)
• session.cookie_secure = 1(仅HTTPS)
• session.use_strict_mode = 1(拒绝未初始化session ID)
• 定期session_regenerate_id()(防会话固定攻击)
• Xdebug:功能最全调试器,支持断点、栈跟踪、性能分析(Profiler)
• PHPDBG:内置CLI调试器(PHP 7.0起)
• Blackfire:商业性能分析工具
• Tideways:轻量级性能监控
• PHPStan:静态分析(类型检查)
• Psalm:静态分析+类型推断
• PHP_CodeSniffer:代码规范检查(支持PSR-12)
• PHP-CS-Fixer:自动格式化代码
• PHPUnit:单元测试标准
• Codeception:全栈测试框架(单元+功能+验收测试)
• Behat:行为驱动开发(BDD)
Dockerfile示例(PHP 8.3-FPM):
FROM php:8.3-fpm
RUN apt-get update && apt-get install -y \
libpq-dev \
libzip-dev \
zip \
unzip \
&& docker-php-ext-install pdo_mysql zip
COPY . /var/www/html
WORKDIR /var/www/html
RUN composer install --optimize-autoloader --no-dev
CMD ["php-fpm"]
当前最流行的PHP框架(GitHub Stars超7万),以优雅语法著称。核心特性:
• Eloquent ORM(活动记录模式)
• Blade模板引擎
• Artisan CLI工具
• Laravel Mix(Webpack封装)
• Scout(全文搜索)
• Horizon(队列监控)
企业级框架,组件化设计。核心组件:
• HttpFoundation(请求/响应对象)
• Routing(路由系统)
• Validator(验证组件)
• Form(表单生成)
• Serializer(序列化)
全球内容管理系统(CMS)龙头,PHP 7.4+兼容性良好。扩展生态:
• 主题(Theme)
• 插件(Plugin)
• Gutenberg块编辑器
• REST API
国内流行框架,以“简单、快速、兼容”为理念。核心特性:
• MVC分层
• 内置模板引擎
• 数据库操作封装
• 行为扩展机制
[php]问题超50万#PHP)