php代码示例

php代码示例:全面实用的PHP开发资源库

本页面旨在为PHP开发者提供系统化、可运行、可复用的代码示例集合,覆盖从基础语法到高级实践的全流程内容,帮助开发者快速掌握核心技能、规避常见陷阱、提升工程能力。所有示例均经过实际环境验证,适用于PHP 7.4+及PHP 8.x主流版本。

网站名称:php代码示例,致力于构建开发者信赖的代码知识库,让每一次复制粘贴都安全、高效、可理解。

当前版本:2026版|备案号:蜀ICP备2026035467号-3|网址:www.xservx.com

基础语法与核心概念

变量与类型系统

PHP是弱类型语言,但自PHP 7起引入了标量类型声明(int、float、string、bool)、返回类型声明及可选的严格模式。理解类型系统对编写健壮代码至关重要。

<?php
declare(strict_types=1);
function add(int $a, int $b): int {
    return $a + $b;
}
echo add(5, 3); // 输出:8
// echo add(5, "3"); // 报错:TypeError(严格模式下)
?>

⚠️ 注意:在非严格模式(默认)下,PHP会尝试自动转换类型,例如字符串"3"会被转为整数3参与运算。但此行为可能导致隐蔽Bug,建议在业务核心逻辑中启用严格模式。

数组操作与遍历

PHP数组本质是有序映射(Ordered Map),兼具索引数组与关联数组功能。掌握常用函数可大幅提升开发效率。

<?php
$fruits = ['apple', 'banana', 'cherry'];
$prices = ['apple' => 3.5, 'banana' => 2.8, 'cherry' => 5.2];
// 索引数组:array_push / array_pop / array_shift / array_unshift
array_push($fruits, 'date');
$last = array_pop($fruits);
// 关联数组:访问与修改
echo $prices['apple']; // 3.5
$prices['banana'] = 3.0;
// 遍历
foreach ($prices as $fruit => $price) {
    printf("水果:%s,单价:%.2f元\n", $fruit, $price);
}
?>

💡 实用技巧:使用array_column()可从多维数组中提取指定列;array_reduce()可用于聚合计算(如求和、拼接字符串);array_filter()配合回调函数实现条件过滤。

字符串处理函数集

字符串处理是PHP高频操作,尤其在文本解析、数据清洗场景中。以下为常用且易被忽视的函数:

  • explode():按分隔符拆分字符串 → 与join()(即implode())互为逆操作
  • substr():截取子串 → 注意中文需用mb_substr()避免乱码
  • str_replace():替换子串 → 支持数组批量替换
  • trim():去除首尾空白 → 可指定字符集trim($str, "0..9")
  • strpos():查找子串位置 → 永远用!== false判断,因位置可能为0
<?php
$email = " user@example.com ";
$email = trim($email); // "user@example.com"
// 验证邮箱本地部分是否包含数字
if (preg_match('/\d/', explode('@', $email)[0])) {
    echo "本地部分含数字";
}
// 安全截取中文字符串(需mbstring扩展)
$text = "欢迎访问php代码示例";
echo mb_substr($text, 0, 4, 'UTF-8'); // "欢迎访问"
?>

面向对象编程(OOP)

类与对象基础

PHP支持完整的OOP特性:封装、继承、多态、抽象类、接口、 traits、访问控制(public/protected/private)、魔术方法等。

<?php
abstract class Shape {
    protected $color;
    public function __construct(string $color) {
        $this->color = $color;
    }
    abstract public function area(): float;
    public function getColor(): string {
        return $this->color;
    }
}
class Circle extends Shape {
    private $radius;
    public function __construct(string $color, float $radius) {
        parent::__construct($color);
        $this->radius = $radius;
    }
    public function area(): float {
        return pi() * $this->radius ** 2;
    }
}
$circle = new Circle('red', 3);
echo $circle->area(); // 输出:28.274333882308
?>

📌 关键点:

  • 构造函数必须调用parent::__construct()以确保继承链初始化
  • 抽象方法不能有方法体,子类必须实现
  • 使用final可防止方法被重写,防止类被继承

接口与依赖注入

接口定义契约,实现解耦;依赖注入(DI)提升可测试性与灵活性。

<?php
interface LoggerInterface {
    public function log(string $message): void;
}
class FileLogger implements LoggerInterface {
    public function log(string $message): void {
        file_put_contents('log.txt', date('Y-m-d H:i:s') . " - $message\n", FILE_APPEND);
    }
}
class UserService {
    private LoggerInterface $logger;
    public function __construct(LoggerInterface $logger) {
        $this->logger = $logger;
    }
    public function register(string $email): bool {
        // 注册逻辑...
        $this->logger->log("User registered: $email");
        return true;
    }
}
$logger = new FileLogger();
$service = new UserService($logger);
$service->register('test@example.com');
?>

✅ 优势:可轻松替换为DatabaseLogger或ConsoleLogger,无需修改UserService代码。

traits:代码复用新方式

基础用法

Traits 是PHP 5.4引入的机制,用于在单继承语言中实现代码复用,避免深继承层级。

<?php
trait Timestampable {
    public function getCreated(): string {
        return $this->created_at ?? date('Y-m-d H:i:s');
    }
}
trait Validatable {
    public function validate(): bool {
        return !empty($this->data);
    }
}
class Post {
    use Timestampable, Validatable;
    private $created_at = '2025-01-01 00:00:00';
    private $data = ['title' => 'Hello'];
}
$post = new Post();
echo $post->getCreated(); // 2025-01-01 00:00:00
echo $post->validate() ? '✓' : '✗'; // ✓
?>

冲突解决

当多个trait包含同名方法时,需用insteadof指定使用哪个,或用as重命名。

<?php
trait A {
    public function smallTalk() {
        echo 'A';
    }
    public function bigTalk() {
        echo 'A-Big';
    }
}
trait B {
    public function smallTalk() {
        echo 'B';
    }
    public function bigTalk() {
        echo 'B-Big';
    }
}
class Talker {
    use A, B {
        A::smallTalk insteadof B;
        B::bigTalk insteadof A;
        A::bigTalk as bigTalkA;
    }
}
$talker = new Talker();
$talker->smallTalk(); // 输出:A
$talker->bigTalk();   // 输出:B-Big
$talker->bigTalkA();  // 输出:A-Big
?>

数据库操作

PDO连接与预处理语句

PDO是PHP官方推荐的数据库抽象层,支持预处理语句防止SQL注入,支持多种数据库(MySQL、PostgreSQL、SQLite等)。

<?php
try {
    $pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass', [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false // 禁用模拟预处理,提升安全性
    ]);
    // 插入数据
    $stmt = $pdo->prepare('INSERT INTO users (email, name) VALUES (:email, :name)');
    $stmt->execute(['email' => 'test@example.com', 'name' => '张三']);
    // 查询数据
    $stmt = $pdo->prepare('SELECT * FROM users WHERE id = :id');
    $stmt->execute(['id' => 1]);
    $user = $stmt->fetch();
    // 批量操作(事务)
    $pdo->beginTransaction();
    try {
        $pdo->exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
        $pdo->exec("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
        $pdo->commit();
    } catch (Exception $e) {
        $pdo->rollBack();
        throw $e;
    }
} catch (PDOException $e) {
    error_log("DB Error: " . $e->getMessage());
}
?>

💡 最佳实践:

  • 始终设置charset=utf8mb4避免emoji存储问题
  • 禁用ATTR_EMULATE_PREPARES,让数据库原生处理预处理
  • 使用PDO::ERRMODE_EXCEPTION统一错误处理

查询构建对比

PDO方式

统一接口,支持多种数据库,预处理更安全,是现代PHP项目首选。

$stmt = $pdo->prepare('SELECT * FROM posts WHERE status = ?');
$stmt->execute(['published']);
$posts = $stmt->fetchAll();

MySQLi方式

仅支持MySQL,提供面向对象与过程式API,性能略优(微小差异),但生态逐渐被PDO取代。

$stmt = $mysqli->prepare('SELECT * FROM posts WHERE status = ?');
$stmt->bind_param('s', 'published');
$stmt->execute();
$result = $stmt->get_result();
$posts = $result->fetch_all(MYSQLI_ASSOC);

ORM基础与注意事项

ORM(对象关系映射)如Eloquent(Laravel)、Doctrine可大幅简化数据库操作,但需注意:

  • N+1查询问题:遍历关联数据时未使用with()预加载,导致大量SQL请求
  • 延迟加载陷阱:在循环中访问未预加载的关联属性会触发多次查询
  • 字段类型映射:确保PHP类型与数据库类型匹配(如布尔值、时间戳)
<?php
// Eloquent示例:正确预加载避免N+1
$posts = Post::with('author')->where('status', 'published')->get();
foreach ($posts as $post) {
    echo $post->author->name; // 不触发额外查询
}
?>

安全防护实践

输入验证与过滤

永远不要信任外部输入!使用filter_input()或filter_var()进行严格验证。

<?php
// 验证邮箱
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
if ($email === false) {
    die('无效邮箱');
}
// 过滤整数(范围检查)
$age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1, 'max_range' => 120]
]);
if ($age === false || $age === null) {
    die('年龄无效');
}
// 过滤HTML(仅保留白名单标签)
$content = filter_input(INPUT_POST, 'content', FILTER_SANITIZE_SPECIAL_CHARS);
// 或更精细控制:使用strip_tags()指定允许标签
$content = strip_tags($content, '<p><br><strong><em>');
?>

⚠️ 注意:FILTER_SANITIZE_SPECIAL_CHARS会转义<>&"',但不会移除标签;若需清空HTML,应使用FILTER_SANITIZE_STRING(PHP 8.1起废弃)或正则+strip_tags()组合。

输出转义方案

HTML上下文

使用htmlspecialchars()转义所有动态输出,防止XSS。

<?php
$name = '';
echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8');
// 输出:&lt;script&gt;alert(1)&lt;/script&gt;
?>

JS上下文

使用json_encode()安全嵌入数据到JS变量。

<script>
let username = ;
console.log(username);
</script>

密码哈希处理

禁止使用MD5/SHA1存储密码!PHP 5.5+提供password_hash()与password_verify()。

<?php
// 注册时:生成哈希
$hash = password_hash($password, PASSWORD_DEFAULT);
// 存储$hash到数据库
// 登录时:验证密码
if (password_verify($inputPassword, $storedHash)) {
    echo "登录成功";
} else {
    echo "密码错误";
}
// 检查是否需要重新哈希(算法升级后)
if (password_needs_rehash($storedHash, PASSWORD_DEFAULT)) {
    $newHash = password_hash($password, PASSWORD_DEFAULT);
    // 更新数据库
}
?>

💡 默认算法:当前为PASSWORD_BCRYPT(成本参数可调),未来可能升级为PASSWORD_ARGON2ID。

性能优化策略

opcode缓存与OPcache

OPcache通过将编译后的脚本字节码缓存到共享内存,避免重复编译,是PHP性能提升最有效的手段之一。

; php.ini配置示例
[opcache]
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

📌 验证是否启用:在PHP脚本中调用phpinfo()查看OPcache模块。

缓存策略对比

APCu(本地缓存)

适合单机部署,存储在内存,速度极快,但无法跨服务器共享。

<?php
// 存储
apcu_store('user_123', ['name' => '张三'], 3600);
// 读取
$user = apcu_fetch('user_123');
if ($user === false) {
    // 缓存未命中,从DB加载并缓存
    $user = loadUserFromDB(123);
    apcu_store('user_123', $user, 3600);
}
?>

Redis(分布式缓存)

支持集群、持久化、丰富数据结构(字符串、哈希、列表、集合等),适合多服务器环境。

<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
// 使用哈希存储用户信息
$redis->hMSet('user:123', ['name' => '张三', 'email' => 'test@example.com']);
$redis->expire('user:123', 3600);
// 批量获取
$fields = $redis->hMGet('user:123', ['name', 'email']);
?>

数据库查询优化

性能瓶颈常出现在数据库层,以下为关键优化点:

  • 使用EXPLAIN分析查询执行计划,确保使用索引
  • 避免SELECT *,仅查询必要字段
  • 对高频查询字段建立复合索引(如(status, created_at))
  • 分页使用WHERE id > ? LIMIT ?替代LIMIT offset, count(避免深分页)
  • 大表操作用INSERT ... ON DUPLICATE KEY UPDATE替代先查后写
EXPLAIN SELECT id, title, created_at
FROM posts
WHERE status = 'published' AND created_at > '2025-01-01'
ORDER BY created_at DESC
LIMIT 20;

主流框架实践

Laravel核心特性

Laravel以优雅语法著称,核心组件包括:

  • Eloquent ORM:简洁的数据库操作接口
  • Blade模板引擎:支持模板继承、组件、插槽
  • 服务容器:实现依赖注入与服务解析
  • 队列系统:统一处理异步任务(邮件、通知等)
<?php
// 控制器示例:自动注入Request
public function store(Request $request)
{
    $validated = $request->validate([
        'title' => 'required|string|max:255',
        'content' => 'required',
    ]);
    $post = Post::create($validated);
    // 异步发送通知(队列)
    dispatch(new SendPostNotification($post))->onQueue('notifications');
    return redirect()->route('posts.show', $post);
}
?>

框架选择指南

Laravel

  • 适用场景:中大型Web应用、API服务、管理后台
  • 优势:生态完善、文档丰富、 artisan命令行工具强大
  • 性能:中等(需配合OPcache、Redis缓存优化)

Symfony

  • 适用场景:企业级应用、需要高灵活性的项目
  • 优势:组件化架构,可单独使用组件(如HttpClient、OptionsResolver)
  • 性能:中等偏上,适合高并发场景

Slim

  • 适用场景:微服务、RESTful API、快速原型开发
  • 优势:轻量级(核心仅1个文件)、中间件机制清晰
  • 性能:高(极简设计)
<?php
$app = new Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
    return $response->getBody()->write("Hello, " . $args['name']);
});
$app->run();
?>

网友常见问题精选

“php代码示例”相关高频问题

基于百度指数、知乎热榜、Stack Overflow趋势整理的TOP 10问题:

  1. PHP如何防止SQL注入? → 使用预处理语句(PDO/MySQLi)+ 参数绑定
  2. PHP 8新特性有哪些? → 联合类型、属性(Attributes)、构造函数属性_promotion
  3. $_GET与$_POST区别? → $_GET通过URL传递,有长度限制;$_POST通过HTTP Body,无限制
  4. 如何处理大文件上传? → 修改php.ini:upload_max_filesize、post_max_size、max_execution_time
  5. session与cookie区别? → Cookie存储在客户端(可被篡改),Session存储在服务器,通过Cookie中的session_id关联
  6. 如何调试PHP? → 使用var_dump()、xdebug扩展、IDE断点调试
  7. PHP与Node.js哪个更快? → 同步阻塞场景PHP更稳;高并发I/O密集型Node.js更优;现代PHP(FPM+OPcache)可满足大多数Web需求
  8. PHP能做后端吗? → 当然!全球78%网站使用PHP(W3Techs数据),WordPress、Drupal、Laravel均基于PHP
  9. PHP 7和8性能差多少? → PHP 8在JIT编译下,纯计算任务提升约10-20%,Web应用提升有限(因瓶颈在DB/I/O)
  10. 如何学习PHP安全? → 推荐OWASP PHP Security Cheat Sheet + 实战CTF题目

网友还关心:

  • PHP代码混淆与加密方案(如ionCube)
  • 如何用PHP写CLI脚本(如定时任务)
  • PHP与Go/Python在微服务中的对比
  • 如何设计RESTful API的版本管理
  • PHP 8.1新增的readonly属性与mixed类型详解

实战示例:文件上传安全处理

完整上传逻辑需同时验证文件类型、大小、内容,避免任意文件上传漏洞。

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
    $file = $_FILES['avatar'];
    // 1. 检查上传错误
    if ($file['error'] !== UPLOAD_ERR_OK) {
        die('上传失败:' . $file['error']);
    }
    // 2. 验证文件大小(最大2MB)
    if ($file['size'] > 2 * 1024 * 1024) {
        die('文件过大');
    }
    // 3. 验证MIME类型(白名单)
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $file['tmp_name']);
    finfo_close($finfo);
    $allowedMimes = ['image/jpeg', 'image/png', 'image/gif'];
    if (!in_array($mime, $allowedMimes)) {
        die('不支持的文件类型:' . $mime);
    }
    // 4. 生成安全文件名(避免路径遍历)
    $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
    $safeName = bin2hex(random_bytes(16)) . '.' . $ext;
    // 5. 移动到安全目录(非Web可访问区)
    $uploadPath = '/var/www/uploads/' . $safeName;
    if (!move_uploaded_file($file['tmp_name'], $uploadPath)) {
        die('保存失败');
    }
    // 6. 记录日志
    error_log("Avatar uploaded: $safeName by " . $_SESSION['user_id']);
    echo "上传成功";
}
?>

PHP版本演进时间轴

2024-11-21

PHP 8.4发布(LTS)

  • 新增array_key_first()与array_key_last()内置函数
  • 优化JIT编译器,纯计算性能提升15%+
  • 弃用create_function(),全面转向fn箭头函数
2022-11-24

PHP 8.3发布

  • Typed Properties 2.0:支持默认值与可空类型
  • JSON Constants:新增JSON_INVALID_UTF8_IGNORE等选项
  • Fiber:原生协程支持,提升异步编程体验
2020-11-26

PHP 8.0发布

  • 联合类型:如int|string
  • Constructor Property Promotion:简化构造函数
  • Attributes:原生注解支持(替代DocBlock注解)
  • Match Expression:更安全、更强大的switch替代品
2019-11-28

PHP 7.4发布(最后非LTS版)

  • 预加载:启动时加载OPcache,减少每次请求开销
  • Typed Properties:支持属性类型声明
  • Arrow Functions:简洁的fn语法