php基础教程——构建扎实的Web开发根基

从零开始掌握PHP核心知识体系,覆盖语法、变量、数组、函数、面向对象、数据库操作、安全防护、调试技巧及周边生态,助您成为具备实战能力的PHP开发者。

立即学习

一、PHP基础认知与学习路径

⚡ 什么是PHP?

PHP(Hypertext Preprocessor)是一种广泛使用的开源服务器端脚本语言,专为Web开发而设计。它嵌入在HTML中执行,可动态生成网页内容,支持与数据库交互、处理表单、管理会话等核心Web功能。

PHP诞生于1995年,由Rasmus Lerdorf创建,历经PHP 3(1998)、PHP 4(2000)、PHP 5(2004,引入面向对象增强)、PHP 7(2015,性能飞跃)到PHP 8(2020,JIT编译器、联合类型等现代特性),其生态系统已覆盖从个人博客到大型企业级应用(如WordPress、Drupal、Laravel、ThinkPHP)的全场景。

据W3Techs统计,截至2024年,全球超77%的已知使用服务端语言的网站采用PHP,包括Facebook早期全栈(后部分迁移至Hack)、WordPress(全球超43%网站运行于其上)、WordPress、Drupal、Magento、Joomla等知名CMS/框架。

⚙️ 为什么选择PHP作为入门语言?

  • 〈低门槛,高上限〉:语法简洁直观,类似C/Java,初学者可快速上手;同时支持现代编程范式(OOP、FP),满足专业开发者需求。
  • 〈开箱即用〉:无需复杂配置,Apache/Nginx + PHP-FPM + MySQL组合即可运行Web应用;内置大量函数覆盖常见场景。
  • 〈生态繁荣〉:Composer包管理、PSR标准规范、Laravel/Symfony等成熟框架、Docker原生支持,形成完整开发生态。
  • 〈部署友好〉:共享虚拟主机普遍支持PHP,成本极低;支持微服务架构,可与Go/Node.js协同。

〔学习路径建议〕

我们推荐分阶段构建知识体系:

  1. 第一阶段:掌握PHP语法基础(变量、运算符、流程控制、函数、数组)
  2. 第二阶段:理解数据存储与交互($_GET/$_POST、文件上传、会话控制)
  3. 第三阶段:连接数据库(MySQLi/PDO),实现CRUD操作
  4. 第四阶段:学习面向对象编程(OOP),设计可复用代码结构
  5. 第五阶段:安全编码实践(XSS、SQL注入、CSRF防护)
  6. 第六阶段:调试与测试(错误报告、日志分析、单元测试)
  7. 第七阶段:工具链与生态(Composer、PSR规范、RESTful API设计)

本教程将严格遵循此路径,结合示例与反例,深入浅出讲解每个环节。

二、PHP核心语法结构详解

PHP脚本标记与执行模型

PHP代码必须包含在特定的标记中,最常用的是<?php ... ?>。这是标准长标记,推荐在所有场景中使用(避免短标记<? ... ?>因配置禁用导致的兼容性问题)。

<?php
echo "Hello, PHP!";
?>

当PHP文件仅包含PHP代码时(如被其他文件include的工具类),可省略结尾的?>,防止意外输出空格或换行导致“headers already sent”错误。

语句结束符

每条PHP语句必须以分号;结尾,这是语法硬性要求。漏写会导致Parse error。例如:

<?php
$name = "PHP";  // 正确
echo $name      // 错误!缺少分号
?>

注释规范

PHP支持三种注释方式:

  • 单行注释:// 注释内容 或 # 注释内容
  • 多行注释:

建议:文档块(DocBlock)使用配合注释标记(如@param、@return),便于IDE解析生成API文档。

变量定义与作用域

PHP变量以$开头,后接合法标识符(字母、下划线开头,可含数字)。变量区分大小写,但关键字(如if、function)不区分。

<?php
$age = 25;
$_name = "Alice";
$price_1 = 99.99;
// 错误示例:以数字开头
// $1price = 50; // Parse error
?>

变量作用域包括:局部(函数内)、全局(脚本级)、静态(static修饰,保持值跨调用存在)。通过global关键字可访问全局变量,但更推荐通过函数参数传递。

数据类型与转换

PHP是弱类型语言,变量类型由赋值自动推断。支持8种原始类型:

类型 说明 示例
integer 整数 42, -10
float 浮点数(双精度) 3.14, -0.001
string 字符串 "Hello", 'World'
boolean 布尔值 true, false
array 数组 [1, 2, 3]
object 对象 new ClassName()
resource 资源(外部资源引用) mysqli_connect()返回值
null 空值 $var = null;

类型转换可通过(int)、(float)、(string)等强制转换,或使用settype()函数。例如:

<?php
$price_str = "99.9";
$price_float = (float)$price_str;  // 结果:99.9
settype($price_str, "float");      // 修改原变量
?>

常量定义

常量通过define()函数或const关键字定义,值在脚本执行期间不可更改。常量名通常大写,无$前缀。

<?php
// 使用 define()
define("APP_NAME", "php基础教程");
// 使用 const(编译时定义,作用域更严格)
const DB_HOST = "localhost";
echo APP_NAME; // 输出:php基础教程
?>

注意:const不能在条件语句或函数内使用(PHP 7.3+已支持类中使用const),而define()可在运行时动态定义。

条件控制语句

PHP提供if、else、elseif及三元运算符? :进行条件判断。推荐使用全等运算符===和!==,避免类型自动转换导致的逻辑错误。

<?php
$score = 85;
if ($score >= 90) {
    $grade = "A";
} elseif ($score >= 80) {
    $grade = "B";
} else {
    $grade = "C";
}
// 三元运算符(嵌套时建议用括号增强可读性)
$status = ($score >= 60) ? "及格" : "不及格";
?>

循环结构

支持for、while、do...while、foreach四种循环。其中foreach专为数组设计,是遍历数组的首选方式。

<?php
$fruits = ["apple", "banana", "cherry"];
// foreach 遍历(推荐)
foreach ($fruits as $index => $fruit) {
    echo ($index + 1) . ". " . $fruit . "\n";
}
// 跳出循环
for ($i = 1; $i <= 10; $i++) {
    if ($i == 5) break;  // 遇5跳出
    echo $i . " ";
}
// 输出:1 2 3 4
?>

switch语句陷阱

switch使用松散比较(==),可能导致意外匹配。例如:

<?php
$code = "0";
switch ($code) {
    case 0:     // "0" == 0 为 true!
        echo "零";
        break;
    case "0":   // 实际不会执行
        echo "字符串零";
        break;
}
?>

解决方案:使用严格比较switch (true) { case ($code === 0): ... },或改用if-elseif结构。

三、数组与数据处理核心技能

数组类型与创建

PHP数组本质上是有序映射(ordered map),可同时作为索引数组(类似列表)和关联数组(类似字典)。创建方式多样:

<?php
// 索引数组
$colors = ["red", "green", "blue"];
// 关联数组
$person = [
    "name" => "张三",
    "age" => 28,
    "city" => "成都"
];
// 使用 array()(旧式,仍兼容)
$numbers = array(1, 2, 3);
// 混合数组(键可混合)
$mixed = [1 => "a", "b" => 2, "c"];
print_r($mixed);
// 输出:Array ( [1] => a [b] => 2 [2] => c )
?>

注意:当未指定索引时,PHP自动分配下一个整数索引。字符串键不会自动递增。

数组操作高频函数

以下函数在数据处理中高频使用,需熟练掌握:

函数 功能 示例
count() 统计数组元素个数 count([1,2,3]) → 3
array_push() 向数组末尾添加元素 array_push($arr, "new")
array_pop() 弹出数组末尾元素 $last = array_pop($arr)
array_shift() 弹出数组开头元素 $first = array_shift($arr)
in_array() 检查值是否存在 in_array("apple", $fruits)
array_key_exists() 检查键是否存在 array_key_exists("name", $person)
array_merge() 合并数组(字符串键覆盖) array_merge($a, $b)
array_filter() 用回调函数过滤元素 array_filter($arr, "is_numeric")
array_map() 为数组每个元素应用回调 array_map("strtoupper", $names)

实际案例:过滤非数字并转换为整数

<?php
$input = ["123", "abc", "456", 789, "0"];
$cleaned = array_map("intval", array_filter($input, "is_numeric"));
print_r($cleaned);
// 输出:Array ( [0] => 123 [2] => 456 [3] => 789 [4] => 0 )
?>

数组排序技巧

PHP提供多种排序函数,注意区分升序/降序、键值保留、类型稳定性:

函数 排序依据 保持键名 稳定性
sort() 值(升序) 否(重置键) 不稳定
rsort() 值(降序) 否 不稳定
asort() 值(升序) 是 稳定
arsort() 值(降序) 是 稳定
ksort() 键(升序) 是 稳定
krsort() 键(降序) 是 稳定

自定义排序:usort()(值)和uksort()(键)允许传入比较函数。例如按字符串长度排序:

<?php
$words = ["php", "javascript", "go", "rust"];
usort($words, function($a, $b) {
    return strlen($a) - strlen($b);
});
print_r($words);
// 输出:Array ( [0] => php [1] => go [2] => rust [3] => javascript )
?>

四、函数设计与高级应用

函数定义基础

函数通过function关键字定义,支持参数默认值、类型声明(PHP 7+)、可变参数等特性。函数名大小写不敏感,但推荐与定义保持一致。

<?php
// 基础函数
function greet($name = "访客") {
    return "你好,$name!";
}
// 带类型声明的函数(PHP 7+)
function add(int $a, float $b): float {
    return $a + $b;
}
// 可变参数函数
function sum(...$numbers) {
    return array_sum($numbers);
}
echo greet("开发者");     // 你好,开发者!
echo add(5, 3.2);        // 8.2
echo sum(1, 2, 3, 4);    // 10
?>

注意:类型声明默认为“软模式”(非严格),可通过declare(strict_types=1);启用严格模式,此时类型不匹配将抛出TypeError。

闭包与匿名函数

PHP支持闭包(Closure),可捕获外部变量并作为回调传递。使用use关键字显式传递变量。

<?php
$discount = 0.9;
// 闭包捕获外部变量
$calculate = function($price) use ($discount) {
    return $price * $discount;
};
echo $calculate(100); // 90
// 修改外部变量(需引用传递)
$rate = 1.5;
$adjust = function($value) use (&$rate) {
    return $value * $rate;
};
$rate = 2.0; // 修改后影响闭包
echo $adjust(50); // 100
?>

闭包常用于array_map、usort等高阶函数,实现灵活的数据处理逻辑。

递归函数与性能考量

递归函数调用自身处理分形问题(如目录遍历、树结构)。但需注意递归深度限制(默认100层),避免栈溢出。

<?php
// 计算阶乘
function factorial($n) {
    if ($n <= 1) return 1;
    return $n * factorial($n - 1);
}
// 递归遍历目录
function listDir($dir) {
    $items = scandir($dir);
    foreach ($items as $item) {
        if ($item === '.' || $item === '..') continue;
        $path = $dir . DIRECTORY_SEPARATOR . $item;
        echo $path . "\n";
        if (is_dir($path)) listDir($path);
    }
}
echo factorial(5); // 120
?>

性能优化建议:对递归函数使用static变量缓存中间结果(记忆化),或改用迭代实现(如用栈模拟递归)。

内置函数扩展技巧

PHP内置函数丰富,但部分函数返回值易混淆(如strpos()返回false或整数,需用===判断)。常用技巧:

  • 〈字符串处理〉:explode()分割字符串,implode()合并数组为字符串,substr()截取子串
  • 〈日期时间〉:date()格式化时间,strtotime()解析时间字符串
  • 〈JSON操作〉:json_encode()编码,json_decode()解码(注意第二个参数true返回关联数组)
  • 〈文件操作〉:file_get_contents()读文件,file_put_contents()写文件

反例:直接比较strpos($str, "a") == 0在字符串以"a"开头时可能返回true,但"0" == 0也为true,导致逻辑错误!正确写法:

<?php
if (strpos($str, "a") === 0) {
    echo "字符串以'a'开头";
}
?>

五、面向对象编程(OOP)实战

类与对象基础

PHP支持完整的OOP特性:类、属性、方法、继承、接口、抽象类、trait。对象通过new关键字创建。

<?php
class User {
    public $name;
    protected $email;
    private $password;
    public function __construct($name, $email, $password) {
        $this->name = $name;
        $this->email = $email;
        $this->password = password_hash($password, PASSWORD_DEFAULT);
    }
    public function getEmail() {
        return $this->email;
    }
    public function setEmail($email) {
        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
            $this->email = $email;
        }
    }
}
$user = new User("李四", "li@example.com", "123456");
echo $user->name;        // 访问公共属性
echo $user->getEmail();  // 通过方法访问受保护属性
?>

访问控制:public(公开)、protected(子类内)、private(仅本类)。推荐使用getter/setter封装属性,确保数据校验。

继承与多态

子类通过extends继承父类,并可重写(override)父类方法。使用parent::调用父类方法。

<?php
class Admin extends User {
    public function __construct($name, $email, $password) {
        parent::__construct($name, $email, $password);
        $this->role = "admin";
    }
    public function getEmail() {
        return "管理员:" . parent::getEmail();
    }
}
$admin = new Admin("王五", "admin@php.com", "admin123");
echo $admin->getEmail(); // 管理员:admin@php.com
?>

多态:父类引用可指向子类对象,调用方法时执行实际对象的版本。

接口与抽象类

接口(interface)定义方法签名,实现类必须实现所有方法,用于规范契约。抽象类(abstract)可包含抽象方法(无实现)和具体方法。

<?php
interface Logger {
    public function log($message);
}
abstract class BaseLogger {
    protected $level;
    public function setLevel($level) {
        $this->level = $level;
    }
    abstract public function log($message);
}
class FileLogger extends BaseLogger implements Logger {
    public function log($message) {
        file_put_contents("log.txt", date("Y-m-d H:i:s") . " [$this->level] $message\n", FILE_APPEND);
    }
}
?>

使用场景:接口用于解耦(如依赖注入),抽象类用于代码复用(共享属性和方法)。

Trait复用机制

Trait是PHP 5.4引入的代码复用机制,解决单继承局限。多个Trait可组合使用,通过insteadof和as解决方法冲突。

<?php
trait Loggable {
    public function log($msg) {
        echo "[LOG] $msg\n";
    }
}
trait Validatable {
    public function validate() {
        return true;
    }
}
class Article {
    use Loggable, Validatable {
        Validatable::validate insteadof Loggable;
        Loggable::log as writeLog;
    }
}
$article = new Article();
$article->writeLog("文章已保存"); // [LOG] 文章已保存
?>

注意:Trait优先级 > 当前类方法 > 父类方法。合理使用Trait可提升代码复用性,但避免过度嵌套导致维护困难。

六、数据库操作与安全实践

MySQLi扩展:面向对象与过程式

MySQLi提供面向对象(OOP)和过程式(Procedural)两种API,推荐使用OOP方式,代码更清晰。

<?php
// 创建连接
$mysqli = new mysqli("localhost", "root", "password", "testdb");
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}
// 预处理语句防SQL注入
$stmt = $mysqli->prepare("SELECT id, name FROM users WHERE email = ?");
$stmt->bind_param("s", $email);
$email = "test@example.com";
$stmt->execute();
$result = $stmt->get_result();
while ($row = $result->fetch_assoc()) {
    echo $row['name'] . "\n";
}
$stmt->close();
$mysqli->close();
?>

关键点:使用prepare()和bind_param()进行参数绑定,避免字符串拼接导致的SQL注入。

PDO:统一接口与事务支持

PDO(PHP Data Objects)支持多种数据库(MySQL、PostgreSQL、SQLite等),提供预处理语句、事务、错误处理等高级特性。

<?php
try {
    $pdo = new PDO("mysql:host=localhost;dbname=testdb;charset=utf8mb4", "root", "password");
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // 开启事务
    $pdo->beginTransaction();
    $stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
    $stmt->execute(["赵六", "zhao@example.com"]);
    $userId = $pdo->lastInsertId();
    $stmt = $pdo->prepare("UPDATE profiles SET user_id = ? WHERE id = 1");
    $stmt->execute([$userId]);
    // 提交事务
    $pdo->commit();
} catch (PDOException $e) {
    // 回滚事务
    $pdo->rollBack();
    echo "失败: " . $e->getMessage();
}
?>

注意:设置charset=utf8mb4确保支持emoji等4字节字符;使用try-catch捕获异常,避免程序崩溃。

常见安全漏洞与防护

● SQL注入

攻击者通过构造恶意输入(如' OR '1'='1)绕过验证。防护:始终使用预处理语句(MySQLi/PDO),禁止直接拼接SQL字符串。

● XSS攻击

攻击者注入恶意脚本(如<script>alert(1)</script>)到页面。防护:输出前使用htmlspecialchars()转义HTML特殊字符。

● CSRF攻击

攻击者诱导用户执行非预期操作(如转账)。防护:在表单中添加CSRF Token,服务端验证Token有效性。

● 文件上传漏洞

上传可执行文件(如.php)导致远程代码执行。防护:严格校验文件类型(MIME+扩展名)、限制文件大小、存储到非Web目录、随机重命名。

查询性能优化建议

  • 〈索引设计〉:为WHERE、JOIN、ORDER BY字段添加索引;避免在索引列上使用函数(如WHERE YEAR(date)=2024)
  • 〈查询优化〉:避免SELECT *,只取必要字段;使用EXPLAIN分析执行计划
  • 〈分页优化〉:大数据量时用WHERE id > last_id LIMIT 100替代LIMIT offset, count
  • 〈连接池〉:长连接应用考虑使用mysqlnd_ms或Swoole连接池

七、安全编码实战指南

输入验证(Validation)

所有外部输入($_GET、$_POST、$_COOKIE、$_SERVER等)必须验证和过滤。PHP提供filter_var()和filter_input()进行安全过滤。

<?php
// 验证邮箱
$email = filter_input(INPUT_POST, "email", FILTER_VALIDATE_EMAIL);
if ($email === false) {
    die("无效邮箱");
}
// 过滤字符串(移除危险字符)
$name = filter_input(INPUT_POST, "name", FILTER_SANITIZE_STRING);
// 验证整数范围
$age = filter_input(INPUT_POST, "age", FILTER_VALIDATE_INT, [
    "options" => ["min_range" => 1, "max_range" => 120]
]);
?>

注意:FILTER_SANITIZE_STRING在PHP 8.1后已弃用,建议用htmlspecialchars()或filter_var(..., FILTER_DEFAULT, FILTER_FLAG_STRIP_LOW)替代。

输出转义(Escaping)

根据上下文选择正确的转义函数:

输出上下文 推荐函数 示例
HTML内容 htmlspecialchars() <?php echo htmlspecialchars($user_input, ENT_QUOTES, 'UTF-8'); ?>
HTML属性 htmlspecialchars() + 单引号包裹 <div title="<?php echo htmlspecialchars($desc, ENT_QUOTES, 'UTF-8'); ?>">
JavaScript json_encode() <script>var msg = <?php echo json_encode($msg, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP); ?>;</script>
URL参数 urlencode() <a href="search.php?q=<?php echo urlencode($keyword); ?>">
SQL查询 预处理语句(非mysql_real_escape_string) 见PDO/MySQLi部分

会话安全(Session Security)

会话劫持是常见攻击方式,需采取以下措施:

  • 〈会话ID轮换〉:登录成功后调用session_regenerate_id(true)生成新ID
  • 〈安全标志〉:设置session.cookie_httponly = 1(防JS窃取)和session.cookie_secure = 1(仅HTTPS)
  • 〈会话超时〉:定期检查$_SESSION['last_activity'],超时销毁会话
  • 〈IP绑定〉(可选):验证$_SERVER['HTTP_USER_AGENT']一致性
<?php
// 登录成功后
session_regenerate_id(true);
$_SESSION['last_activity'] = time();
// 检查会话超时
if (isset($_SESSION['last_activity']) && (time() - $_SESSION['last_activity'] > 1800)) {
    session_unset();
    session_destroy();
    session_start();
}
?>

密码安全处理

禁止明文存储密码!使用password_hash()和password_verify():

<?php
// 注册时加密存储
$hash = password_hash($password, PASSWORD_DEFAULT);
// 存储$hash到数据库
// 登录时验证
if (password_verify($input_password, $stored_hash)) {
    // 密码正确
    if (password_needs_rehash($stored_hash, PASSWORD_DEFAULT)) {
        $new_hash = password_hash($input_password, PASSWORD_DEFAULT);
        // 更新数据库中的hash
    }
}
?>

说明:PASSWORD_DEFAULT默认使用bcrypt算法,未来可能升级为Argon2;password_needs_rehash()确保哈希随算法升级而更新。

八、调试与错误处理技巧

错误报告配置

开发环境应开启完整错误报告,生产环境关闭显示但记录日志:

<?php
// 开发环境
error_reporting(E_ALL);
ini_set('display_errors', 1);
// 生产环境
error_reporting(E_ALL);
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', '/var/log/php_errors.log');
?>

注意:生产环境display_errors=0防止敏感信息泄露,但需确保log_errors=1记录错误到文件。

调试工具与技巧

  • 〈var_dump()〉:显示变量详细信息(类型、值、长度),适合简单调试
  • 〈print_r()〉:可读性更好的数组/对象输出,print_r($arr, true)返回字符串
  • 〈debug_zval_dump()〉:显示引用计数,分析内存问题
  • 〈debug_backtrace()〉:获取调用栈,定位错误来源
  • 〈Xdebug〉:功能强大的调试扩展,支持断点调试、性能分析(profiler)、代码覆盖率
  • 〈PHPDBG〉:内置命令行调试器,支持断点、单步执行
  • 〈IDE调试〉:VS Code + PHP Debug扩展,或PHPStorm内置调试器
  • 〈日志分析〉:结合error_log()和ELK栈(Elasticsearch, Logstash, Kibana)

示例:Xdebug配置(php.ini)

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

异常处理(Exception Handling)

使用try-catch捕获异常,避免程序崩溃。自定义异常类可实现业务逻辑分离。

<?php
class DatabaseException extends Exception {
    public function __construct($message, $code = 0, Exception $previous = null) {
        parent::__construct("DB Error: $message", $code, $previous);
    }
}
try {
    $pdo = new PDO(...);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->query("SELECT * FROM nonexistent_table");
} catch (PDOException $e) {
    throw new DatabaseException($e->getMessage(), $e->getCode(), $e);
} catch (Exception $e) {
    error_log($e->getMessage());
    echo "系统繁忙,请稍后再试";
}
?>

注意:避免空catch块,应记录日志或提供有意义的错误信息。

九、现代PHP开发工具链

Composer依赖管理

Composer是PHP的依赖管理器,类似Node.js的npm。核心概念:

  • 〈composer.json〉:项目配置文件,定义依赖、自动加载规则
  • 〈composer.lock〉:锁定依赖版本,确保环境一致性
  • 〈vendor/〉:自动下载的依赖包目录
<?php
// 示例:composer.json
{
    "require": {
        "monolog/monolog": "^2.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}
?>

安装依赖:composer install;更新依赖:composer update;生成自动加载文件:composer dump-autoload。

PSR规范标准

PSR(PHP Standards Recommendations)是PHP框架互操作性标准,由PHP-FIG组织制定:

PSR编号 名称 内容
PSR-1 基本编码规范 命名空间、类名、方法名、文件编码
PSR-2 代码风格规范 缩进、换行、大括号位置(已弃用,建议用PSR-12)
PSR-4 自动加载规范 定义类文件与命名空间的映射关系
PSR-6 缓存接口 统一缓存操作接口(get/set/delete)
PSR-7 HTTP消息接口 Request/Response等消息对象规范
PSR-11 容器接口 依赖注入容器的统一接口
PSR-12 编码风格扩展 PSR-2的增强版,支持PHP 7+新特性

实践:使用PHP_CodeSniffer(PHPCS)和PHP-CS-Fixer自动检查和修复代码风格。

RESTful API设计要点

基于HTTP协议的API设计应遵循以下原则:

  • 〈资源导向〉:URL使用名词复数(如/users),避免动词
  • 〈HTTP方法〉:GET(查询)、POST(创建)、PUT/PATCH(更新)、DELETE(删除)
  • 〈状态码〉:200(成功)、201(创建)、400(参数错误)、401(未认证)、403(无权限)、404(不存在)、500(服务器错误)
  • 〈版本控制〉:URL路径(/api/v1/users)或Accept头(Accept: application/vnd.api.v1+json)
  • 〈分页与过滤〉:使用?page=2&size=20&name=张三查询参数

示例响应结构:

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "name": "张三"
  }
}

十、PHP周边生态与扩展知识

PHP 8关键特性速览

PHP 8(2020年11月发布)引入多项重大改进:

特性 说明 示例
联合类型 参数可接受多种类型 function process(int|string $data)
构造器属性提升 简化OOP属性定义 class User { public function __construct(public string $name) {} }
匹配表达式 更安全的switch替代 match ($status) { 1 => 'active', 0 => 'inactive' }
JIT编译器 性能提升(特定场景) 数值计算密集型代码加速
空合并赋值运算符 简化null检查 $a ??= "default";

未来趋势:Serverless与PHP

随着云原生发展,PHP在Serverless领域崭露头角:

  • 〈AWS Lambda支持PHP运行时〉:通过Custom Runtime运行PHP
  • 〈Bref框架〉:专为Serverless设计的PHP工具集
  • 〈OpenWhisk/Google Cloud Run〉:支持容器化PHP部署

优势:按需付费、自动扩缩容;适用场景:轻量级API、定时任务、事件驱动处理。

挑战:冷启动延迟、状态管理(需外部存储)、调试复杂度增加。