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');
// 输出:<script>alert(1)</script>
?>
JS上下文
使用json_encode()安全嵌入数据到JS变量。
<script>
let username = = json_encode($username, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT) ?>;
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问题:
- PHP如何防止SQL注入? → 使用预处理语句(PDO/MySQLi)+ 参数绑定
- PHP 8新特性有哪些? → 联合类型、属性(Attributes)、构造函数属性_promotion
- $_GET与$_POST区别? → $_GET通过URL传递,有长度限制;$_POST通过HTTP Body,无限制
- 如何处理大文件上传? → 修改php.ini:
upload_max_filesize、post_max_size、max_execution_time - session与cookie区别? → Cookie存储在客户端(可被篡改),Session存储在服务器,通过Cookie中的session_id关联
- 如何调试PHP? → 使用
var_dump()、xdebug扩展、IDE断点调试 - PHP与Node.js哪个更快? → 同步阻塞场景PHP更稳;高并发I/O密集型Node.js更优;现代PHP(FPM+OPcache)可满足大多数Web需求
- PHP能做后端吗? → 当然!全球78%网站使用PHP(W3Techs数据),WordPress、Drupal、Laravel均基于PHP
- PHP 7和8性能差多少? → PHP 8在JIT编译下,纯计算任务提升约10-20%,Web应用提升有限(因瓶颈在DB/I/O)
- 如何学习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版本演进时间轴
PHP 8.4发布(LTS)
- 新增
array_key_first()与array_key_last()内置函数 - 优化JIT编译器,纯计算性能提升15%+
- 弃用
create_function(),全面转向fn箭头函数
PHP 8.3发布
- Typed Properties 2.0:支持默认值与可空类型
- JSON Constants:新增
JSON_INVALID_UTF8_IGNORE等选项 - Fiber:原生协程支持,提升异步编程体验
PHP 8.0发布
- 联合类型:如
int|string - Constructor Property Promotion:简化构造函数
- Attributes:原生注解支持(替代DocBlock注解)
- Match Expression:更安全、更强大的
switch替代品
PHP 7.4发布(最后非LTS版)
- 预加载:启动时加载OPcache,减少每次请求开销
- Typed Properties:支持属性类型声明
- Arrow Functions:简洁的
fn语法