php写法 —— 精准掌握PHP开发的艺术与科学

在当今Web开发领域,PHP虽已步入成熟期,却从未停止进化。从1995年Rasmus Lerdorf创建PHP/FI,到1997年PHP 2.0发布,再到1998年PHP 3.0奠定现代PHP基础,2004年PHP 5引入Zend Engine II实现面向对象突破,直至2015年PHP 7带来性能飞跃,2020年PHP 8引入JIT编译器与联合类型……每一次迭代都在重塑“php写法”的范式边界。

本页面聚焦于“php写法”的系统性实践,涵盖从变量声明、函数定义、类与对象、异常处理到现代PHP 8+新特性(如命名参数、属性、匹配表达式、构造器属性提升),并延伸至与之强相关的周边技术栈:MySQL高性能查询、Redis缓存策略、Nginx反向代理配置、Docker容器化部署、Composer依赖管理、PSR规范遵循、安全防护机制、性能调优路径等。

“php写法”不仅是语法组合,更是工程思维的体现。一份优秀的php写法应具备:
• 清晰的结构层次(分层架构、单一职责)
• 明确的类型约束(标量类型声明、返回类型、可空类型)
• 健壮的异常处理(自定义异常、错误捕获)
• 可复用的模块设计( traits、接口、依赖注入)
• 可测试的代码结构(mock对象、单元测试框架)
• 与生态兼容的规范(PSR-12编码规范、PSR-7 HTTP消息)

本页以实战为导向,通过大量真实代码片段、常见误区解析、性能对比实验与安全防护指南,帮助开发者从“能写PHP”进阶为“会写PHP”。

为什么关注“php写法”?

根据2023年Stack Overflow开发者调查,PHP仍以47.1%的使用率位居Web后端语言前三;根据W3Techs数据,全球43.2%的网站使用PHP(截至2024年6月),包括WordPress(CMS市场份额64.8%)、Drupal、Laravel、Symfony、ThinkPHP、Yii等主流框架均基于PHP构建。

但“使用率高”不等于“写法优”。大量遗留代码存在以下问题:
• 全局变量滥用($GLOBALS、extract()、register_globals)
• 字符串拼接SQL导致SQL注入
• 错误处理依赖error_reporting(E_ALL)而非异常机制
• 无类型约束导致运行时类型错误
• 不使用命名空间导致类名冲突
• 不遵循PSR规范导致协作困难

本页将系统性地纠正这些“php写法”误区,助您写出符合现代工程标准的PHP代码。

⚡ PHP基础写法:从变量到函数的规范表达

1. 变量与类型:严格模式下的类型安全

PHP 7+支持严格类型模式(declare(strict_types=1);),应在每个入口文件顶部启用。否则,PHP将自动进行类型 coercion(强制转换),导致意外行为:

<?php
declare(strict_types=1);
function sum(int $a, int $b): int {
    return $a + $b;
}
// 严格模式下,以下调用将抛出TypeError
// sum(1.5, "2");  // TypeError: Argument #1 must be of type int, float given
// 正确写法:显式转换
sum((int)1.5, (int)"2"); // 3

【典型误区】
❌ $data = $_POST['user'] ?? null; // 若user不存在则为null,后续未判空直接使用
✅ $data = $_POST['user'] ?? ''; // 提供默认空字符串
✅ if (isset($_POST['user']) && is_string($_POST['user'])) { ... } // 显式检查

2. 函数定义:参数类型与返回类型

现代“php写法”应明确声明参数类型与返回类型:

<?php
declare(strict_types=1);
function calculateAge(DateTimeInterface $birthDate, DateTime $now = null): int {
    $now ??= new DateTime();
    $interval = $birthDate->diff($now);
    return (int)$interval->y;
}
// 调用示例
$age = calculateAge(new DateTime('1990-05-20')); // 34(2024年)

【PHP 8+新特性】
• 构造器属性提升(Constructor Property Promotion)
• 匹配表达式(Match Expression)替代冗长if-else
• 命名参数(Named Arguments)提升可读性

<?php
class User {
    public function __construct(
        public string $name,
        public int $age,
        public ?string $email = null
    ) {}
}
// 命名参数调用
$user = new User(
    age: 28,
    name: "张三",
    email: "zhangsan@example.com"
);
// 匹配表达式替代switch
$status = 'pending';
$message = match($status) {
    'pending' => '待处理',
    'approved' => '已批准',
    'rejected' => '已拒绝',
    default => throw new InvalidArgumentException('未知状态'),
};

3. 数组操作:推荐使用数组解构与箭头函数

PHP 7.1+支持列表解构(list()),7.4+支持箭头函数(arrow functions):

<?php
declare(strict_types=1);
// 列表解构(PHP 7.1+)
list($name, $email) = ['李四', 'lisi@example.com'];
// 等价于
[$name, $email] = ['李四', 'lisi@example.com'];
// 箭头函数(PHP 7.4+)
$users = [
    ['id' => 1, 'name' => '王五', 'score' => 85],
    ['id' => 2, 'name' => '赵六', 'score' => 92],
];
$names = array_map(fn($u) => $u['name'], $users);
// 结果:['王五', '赵六']
// 闭包变量自动捕获(无需use)
$totalScore = array_reduce($users, fn($carry, $u) => $carry + $u['score'], 0);
// 结果:177

4. 错误与异常:统一处理机制

“php写法”应避免die()、echo错误信息,改用异常机制:

<?php
declare(strict_types=1);
class DatabaseException extends RuntimeException {}
class ValidationException extends RuntimeException {}
function validateUser(array $data): array {
    if (!isset($data['email']) || !filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        throw new ValidationException('邮箱格式无效');
    }
    if (!isset($data['password']) || strlen($data['password']) < 8) {
        throw new ValidationException('密码长度至少8位');
    }
    return $data;
}
try {
    $user = validateUser(['email' => 'bad@email', 'password' => '123']);
} catch (ValidationException $e) {
    error_log('用户验证失败:' . $e->getMessage());
    http_response_code(400);
    echo json_encode(['error' => $e->getMessage()]);
}

【PHP 8.0+统一错误处理】
Error与Exception统一继承Throwable接口,可统一捕获:

try {
    // ...
} catch (Throwable $e) {
    // 捕获所有错误与异常
}

⚙️ PHP进阶写法:面向对象、设计模式与代码组织

1. 类与接口:抽象与解耦

现代“php写法”应遵循面向对象设计原则:

<?php
declare(strict_types=1);
// 接口定义契约
interface LoggerInterface {
    public function log(string $message, string $level = 'info'): void;
}
// 具体实现
class FileLogger implements LoggerInterface {
    private string $filePath;
    public function __construct(string $filePath) {
        $this->filePath = $filePath;
    }
    public function log(string $message, string $level = 'info'): void {
        $entry = sprintf("[%s] [%s] %s\n", date('Y-m-d H:i:s'), strtoupper($level), $message);
        file_put_contents($this->filePath, $entry, FILE_APPEND | LOCK_EX);
    }
}
// 依赖注入:不依赖具体实现
class UserService {
    private LoggerInterface $logger;
    public function __construct(LoggerInterface $logger) {
        $this->logger = $logger;
    }
    public function registerUser(string $email): bool {
        // ... 业务逻辑
        $this->logger->log("用户注册:{$email}", 'info');
        return true;
    }
}
// 使用
$logger = new FileLogger('/var/log/app.log');
$service = new UserService($logger);
$service->registerUser('newuser@example.com');

2. trait复用:横向复用逻辑

当多个类需共享非继承关系的逻辑时,使用trait:

<?php
declare(strict_types=1);
trait Timestampable {
    public function createdAt(): string {
        return date('Y-m-d H:i:s');
    }
    public function updatedAt(): string {
        return date('Y-m-d H:i:s');
    }
}
class Post {
    use Timestampable;
    private string $title;
    public function __construct(string $title) { $this->title = $title; }
    public function getTitle(): string { return $this->title; }
}
class Comment {
    use Timestampable;
    private string $content;
    public function __construct(string $content) { $this->content = $content; }
    public function getContent(): string { return $this->content; }
}
$post = new Post("PHP写法指南");
echo $post->createdAt(); // 2024-06-15 14:30:22

3. 生成器(Generator):内存高效的迭代

处理大数据集时,避免一次性加载到内存:

<?php
declare(strict_types=1);
function readLargeFile(string $filePath): Generator {
    $handle = fopen($filePath, 'r');
    try {
        while (!feof($handle)) {
            yield fgets($handle);
        }
    } finally {
        fclose($handle);
    }
}
// 使用
foreach (readLargeFile('/var/log/access.log') as $line) {
    // 每次只读取一行,内存占用恒定
    if (strpos($line, 'ERROR') !== false) {
        echo $line;
    }
}

4. 反射与注解:框架底层基石

PHP反射API(ReflectionClass、ReflectionMethod等)支持运行时检查类结构:

<?php
declare(strict_types=1);
class UserService {
    public function getUser(int $id): array {
        return ['id' => $id, 'name' => '测试用户'];
    }
    private function logAction(string $action): void {
        echo "记录操作:{$action}\n";
    }
}
$reflection = new ReflectionClass(UserService::class);
// 列出方法
foreach ($reflection->getMethods() as $method) {
    echo "方法:{$method->getName()},可见性:" . ($method->isPublic() ? 'public' : 'private') . "\n";
}
// 输出:
// 方法:getUser,可见性:public
// 方法:logAction,可见性:private
// 调用私有方法(需设置可访问)
$method = $reflection->getMethod('logAction');
$method->setAccessible(true);
$service = new UserService();
$method->invoke($service, '用户登录');
// 输出:记录操作:用户登录

【注解(DocBlock)解析】
虽然PHP无原生注解,但可通过反射解析DocBlock实现类似功能(如Symfony Annotations):

<?php
declare(strict_types=1);
class ApiUserController {
    public function getUser(int $id): array {
        return ['id' => $id];
    }
}
// 通过反射读取注解
$reflection = new ReflectionClass(ApiUserController::class);
$docComment = $reflection->getDocComment();
// 可解析为路由配置

🔒 PHP安全写法:防御性编程的10大实践

1. SQL注入防护:预处理语句是唯一安全方案

❌ 错误写法:

$query = "SELECT * FROM users WHERE email = '" . $_GET['email'] . "'";

✅ 正确写法(PDO):

<?php
declare(strict_types=1);
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = :email');
$stmt->execute(['email' => $_GET['email']]);
$user = $stmt->fetch();

2. XSS防护:输出上下文转义

❌ 错误写法:

<div>欢迎,</div>

✅ 正确写法:

<div>欢迎,</div>

3. CSRF防护:令牌验证

生成CSRF令牌并验证:

<?php
session_start();
// 生成令牌(登录后或表单渲染前)
if (empty($_SESSION['csrf_token'])) {
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
?>
<form method="POST">
    <input type="hidden" name="csrf_token" value="">
    <!-- 其他表单字段 -->
</form>

验证令牌:

<?php
session_start();
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (!hash_equals($_SESSION['csrf_token'] ?? '', $_POST['csrf_token'] ?? '')) {
        http_response_code(403);
        die('CSRF令牌无效');
    }
    // 处理表单
}

4. 文件上传安全:白名单校验

❌ 错误写法(仅检查扩展名):

$allowed = ['jpg','png','gif'];
if (in_array(pathinfo($_FILES['upload']['name'], PATHINFO_EXTENSION), $allowed)) {
    move_uploaded_file($_FILES['upload']['tmp_name'], '/uploads/' . $_FILES['upload']['name']);
}

✅ 正确写法( MIME + 内容校验):

<?php
declare(strict_types=1);
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mimeType = $finfo->file($_FILES['upload']['tmp_name']);
if (in_array($mimeType, $allowedTypes)) {
    // 进一步校验内容(如图片尺寸、元数据)
    $imageInfo = getimagesize($_FILES['upload']['tmp_name']);
    if ($imageInfo !== false) {
        $extension = image_type_to_extension($imageInfo[2], false);
        $safeName = bin2hex(random_bytes(16)) . '.' . $extension;
        move_uploaded_file($_FILES['upload']['tmp_name'], '/uploads/' . $safeName);
    }
}

5. 密码存储:使用password_hash与password_verify

❌ 错误写法:

$hashed = md5($password);

✅ 正确写法:

<?php
// 注册时
$hashed = password_hash($password, PASSWORD_DEFAULT);
// 登录时验证
if (password_verify($inputPassword, $storedHash)) {
    // 密码正确
}

6. 错误信息:生产环境禁用显示

.htaccess或php.ini配置:

display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log

7. 输入过滤:filter_input系列函数

<?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]
]);

8. 会话安全:安全配置session

<?php
session_set_cookie_params([
    'lifetime' => 0,
    'path' => '/',
    'domain' => $_SERVER['HTTP_HOST'],
    'secure' => true,      // 仅HTTPS
    'httponly' => true,    // 禁止JS访问
    'samesite' => 'Strict' // 防CSRF
]);
session_start();

9. 命令执行:禁用危险函数+白名单

php.ini中禁用危险函数:

disable_functions = exec,passthru,shell_exec,system,proc_open,popen

必须执行时(如系统命令):

<?php
$allowedCommands = ['ls', 'date', 'whoami'];
$cmd = basename($_GET['cmd']); // 防止路径遍历
if (in_array($cmd, $allowedCommands)) {
    exec(escapeshellcmd($cmd), $output, $returnVar);
}

10. 安全头:HTTP响应头加固

.htaccess配置:

Header always set Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self';"
Header always set X-Content-Type-Options "nosniff"
Header always set X-Frame-Options "DENY"
Header always set X-XSS-Protection "1; mode=block"
Header always set Referrer-Policy "strict-origin-when-cross-origin"

🚀 PHP性能写法:从毫秒到微秒的优化路径

1. 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.save_comments=0
opcache.fast_shutdown=1

2. 内存管理:避免不必要的复制

❌ 错误写法(传递大数组):

function processArray($data) { ... }
processArray($largeData); // 传递副本,内存翻倍

✅ 正确写法(引用传递):

function processArray(array &$data) { ... }
processArray($largeData); // 仅传递引用

3. 字符串操作:使用数组函数替代循环拼接

❌ 错误写法:

$str = '';
for ($i = 0; $i < 10000; $i++) {
    $str .= $i . ',';
}

✅ 正确写法:

$parts = [];
for ($i = 0; $i < 10000; $i++) {
    $parts[] = $i;
}
$str = implode(',', $parts);

4. 数据库优化:索引与查询缓存

【索引最佳实践】
• 主键自动建索引
• WHERE、JOIN、ORDER BY字段建索引
• 复合索引遵循最左前缀原则
• 避免在索引列上使用函数(如WHERE YEAR(date)=2024)

【查询缓存】
MySQL 5.7+已移除查询缓存,改用应用层缓存(Redis):

<?php
$redis = new Redis();
$key = "user_{$id}";
$user = $redis->get($key);
if ($user === false) {
    $user = $db->query("SELECT * FROM users WHERE id = ?", [$id])->fetch();
    $redis->set($key, json_encode($user), 3600);
}

5. 异步处理:任务队列解耦

使用Redis + Supervisor实现后台任务:

<?php
// 生产者
$redis->lPush('email_queue', json_encode([
    'to' => 'user@example.com',
    'subject' => '欢迎注册',
    'body' => '...'
]));
// 消费者(worker.php)
while (true) {
    $job = $redis->brPop('email_queue', 5);
    if ($job) {
        $data = json_decode($job[1], true);
        mail($data['to'], $data['subject'], $data['body']);
    }
}

6. 懒加载:延迟初始化对象

避免在构造函数中执行昂贵操作:

<?php
class DatabaseService {
    private ?PDO $pdo = null;
    public function getConnection(): PDO {
        if ($this->pdo === null) {
            $this->pdo = new PDO(...);
        }
        return $this->pdo;
    }
}

7. JIT编译:PHP 8+的性能红利

PHP 8.0+引入JIT(Just-In-Time),虽不改变语义,但对纯计算密集型代码有提升:

php -d opcache.jit_buffer_size=100M -d opcache.jit=tracing script.php

8. 性能分析工具

推荐工具:

<?php
// 临时性能测试
$start = microtime(true);
// 业务逻辑
echo '耗时:' . round((microtime(true) - $start) * 1000, 2) . 'ms';

🌐 PHP生态写法:与周边技术协同的最佳实践

1. Composer依赖管理

composer.json规范:

{
    "name": "vendor/project",
    "description": "PHP写法指南项目",
    "type": "library",
    "require": {
        "php": "^8.1",
        "monolog/monolog": "^3.0",
        "vlucas/phpdotenv": "^5.5"
    },
    "require-dev": {
        "phpunit/phpunit": "^10.0",
        "phpstan/phpstan": "^1.10"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },
    "scripts": {
        "test": "phpunit",
        "analyse": "phpstan analyse src"
    }
}

2. PSR规范遵循

PSR-12编码规范关键点:

3. HTTP消息:PSR-7标准

使用Guzzle实现HTTP客户端:

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
$client = new Client(['base_uri' => 'https://api.example.com']);
try {
    $response = $client->get('/users/123', [
        'headers' => [
            'Authorization' => 'Bearer ' . $token,
            'Accept' => 'application/json'
        ]
    ]);
    $data = json_decode($response->getBody(), true);
} catch (RequestException $e) {
    error_log('API调用失败:' . $e->getMessage());
}

4. Nginx配置:PHP-FPM优化

nginx.conf关键配置:

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    # 关键优化
    fastcgi_buffer_size 128k;
    fastcgi_buffers 4 256k;
    fastcgi_busy_buffers_size 256k;
}

5. Docker容器化部署

Dockerfile示例:

FROM php:8.1-fpm-alpine
RUN apk add --no-cache \
    libpng-dev libjpeg-tiff-dev libwebp-dev freetype-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg --with-webp \
    && docker-php-ext-install gd mysqli opcache
WORKDIR /var/www
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader
COPY . .
RUN chown -R www-data:www-data /var/www/storage
EXPOSE 9000
CMD ["php-fpm"]

6. Redis缓存写法

缓存策略:Cache-aside模式

<?php
class CacheService {
    private Redis $redis;
    public function __construct() {
        $this->redis = new Redis();
        $this->redis->connect('127.0.0.1', 6379);
    }
    public function getWithCache(string $key, callable $loader, int $ttl = 3600) {
        $cached = $this->redis->get($key);
        if ($cached !== false) {
            return json_decode($cached, true);
        }
        $data = $loader();
        $this->redis->setex($key, $ttl, json_encode($data));
        return $data;
    }
}
// 使用
$cache = new CacheService();
$users = $cache->getWithCache('users_list', function() {
    return $db->query("SELECT * FROM users")->fetchAll();
});

7. MySQL连接池与持久化

使用PDO持久连接(谨慎使用):

<?php
$pdo = new PDO(
    'mysql:host=localhost;dbname=test;charset=utf8mb4',
    'user', 'pass',
    [
        PDO::ATTR_PERSISTENT => true, // 持久连接
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
    ]
);

⚠️ 注意:需调整MySQL max_connections与wait_timeout,避免连接泄漏

🛠️ PHP开发工具写法:提升效率的9款利器

1. PHPStan:静态分析

安装:

composer require --dev phpstan/phpstan

运行:

vendor/bin/phpstan analyse src --level=9

2. Psalm:类型检查增强

支持更细粒度的类型推断:

vendor/bin/psalm --output-format=checkstyle

3. PHP-CS-Fixer:代码格式化

安装并配置:

composer require --dev friendsofphp/php-cs-fixer

.php-cs-fixer.php:

<?php
return (new PhpCsFixer\Config())
    ->setRules([
        '@PSR12' => true,
        'array_syntax' => ['syntax' => 'short'],
        'ordered_imports' => true,
    ])
    ->setFinder(
        PhpCsFixer\Finder::create()
            ->in(__DIR__ . '/src')
    );

4. PHPUnit:单元测试

测试用例示例:

<?php
declare(strict_types=1);
use PHPUnit\Framework\TestCase;
class UserServiceTest extends TestCase {
    public function testCalculateAge(): void {
        $birthDate = new DateTime('1990-05-20');
        $now = new DateTime('2024-06-15');
        $age = calculateAge($birthDate, $now);
        $this->assertEquals(34, $age);
    }
}

5. Xdebug:调试与性能分析

php.ini配置:

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

6. Composer Scripts:自动化任务

composer.json:

"scripts": {
    "test": "phpunit",
    "cs": "php-cs-fixer fix src",
    "stan": "phpstan analyse src",
    "analyze": [
        "@cs",
        "@stan",
        "@test"
    ]
}

7. Symfony VarDumper:调试增强

替代var_dump:

<?php
dump($user);
dumpr($user); // 递归展开

8. Laravel Tinker:交互式调试

在项目中使用:

php artisan tinker

9. VS Code + PHP Intelephense

关键设置:

{
    "intelephense.environment.phpVersion": "8.1",
    "intelephense.stubs": ["pdo", "mysqli", "gd", "redis"],
    "intelephense.completion.fullyQualifyGlobalConstantsAndFunctions": true
}

❓ 网友们还关心:php写法常见问题深度解答

PHP 7 vs PHP 8?
MVC vs Active Record?
全局变量 vs 依赖注入?
面向过程 vs 面向对象?

PHP 7与PHP 8的核心差异

  • 性能:PHP 8.0引入JIT,对纯计算密集型任务提升15-30%,但Web应用提升有限(因I/O瓶颈)
  • 类型系统:PHP 8新增联合类型(int|string)、联合类型默认值(?int)、构造器属性提升
  • 匹配表达式:match替代switch,支持严格比较与返回值
  • 命名参数:支持按名传递参数,提升可读性
  • 属性(Attributes):原生注解支持(替代DocBlock)
  • 错误处理:更多错误抛出TypeError而非E_ERROR
// PHP 8 匹配表达式
$status = match(true) {
    $score >= 90 => 'A',
    $score >= 80 => 'B',
    $score >= 70 => 'C',
    default => 'D',
};
// PHP 8 构造器属性提升
class User {
    public function __construct(
        public string $name,
        public int $age,
        public ?string $email = null
    ) {}
}

MVC与Active Record模式对比

特性MVC模式Active Record模式
核心思想分离业务逻辑、数据、视图模型对象同时封装数据与行为
适用场景大型复杂应用中小型应用、快速开发
示例框架Laravel、SymfonyCodeIgniter、Ruby on Rails
扩展性高(可组合多个模型)低(模型耦合)
测试难度低(依赖注入易Mock)高(直接访问DB)

【推荐写法】
• 复杂业务 → 使用Repository模式 + Service层
• 简单CRUD → Active Record足够
• 避免在Model中写SQL拼接 → 使用Query Builder

全局变量与依赖注入对比

  • 全局变量问题:
    - 隐式依赖 → 难以测试
    - 全局状态 → 并发冲突
    - 污染命名空间
  • 依赖注入优势:
    - 显式依赖 → 清晰接口
    - 可替换实现 → 便于Mock
    - 符合SOLID原则
// 全局变量写法(不推荐)
function sendEmail($to, $subject, $body) {
    global $smtpConfig;
    $mailer = new SmtpMailer($smtpConfig);
    return $mailer->send($to, $subject, $body);
}
// 依赖注入写法(推荐)
class EmailService {
    private SmtpMailer $mailer;
    public function __construct(SmtpMailer $mailer) {
        $this->mailer = $mailer;
    }
    public function send(string $to, string $subject, string $body): bool {
        return $this->mailer->send($to, $subject, $body);
    }
}
// 使用
$mailer = new SmtpMailer($config);
$service = new EmailService($mailer);
$service->send('user@example.com', 'Hi', 'Hello');

面向过程与面向对象的选择

  • 面向过程:
    - 优点:简单直接、无类开销
    - 缺点:难复用、难测试
    - 适用:脚本工具、小型项目
  • 面向对象:
    - 优点:易复用、易扩展、支持多态
    - 缺点:学习曲线陡、类文件增多
    - 适用:中大型应用、团队协作

【混合写法建议】
• 入口文件(index.php):面向过程
• 业务逻辑:面向对象(Service + Repository)
• 工具函数:全局函数(避免污染类)

2024年php写法最佳实践总结

✅ 必做:
• 使用PHP 8.1+
• 启用strict_types
• 遵循PSR-12
• 使用Composer管理依赖
• 关键路径加类型约束
• 所有外部输入做校验
• 错误统一异常处理
• 日志记录关键操作
• 定期运行PHPStan

❌ 避免:
• 直接拼接SQL
• die()输出错误
• 全局变量传递状态
• 在循环中创建对象
• 忽略内存泄漏(如长驻进程)
• 使用未过滤的$_GET/$_POST
• 在视图中写复杂逻辑

【终极建议】
“php写法”的本质是:
**清晰表达意图 + 降低认知负荷 + 防御性设计**

⏱️ php写法演进时间轴

1995年:Rasmus Lerdorf创建PHP/FI

最初名为Personal Home Page Tools,用于追踪网站访问量。首个支持MySQL的Web脚本语言。

1998年:PHP 3.0发布

引入Zend Engine 1.0,支持模块化扩展,奠定现代PHP基础。

2004年:PHP 5.0发布

Zend Engine II带来完整OOP支持(类、接口、异常),成为PHP 5时代基石。

2015年:PHP 7.0发布

性能提升2倍,内存占用减半,引入标量类型声明、匿名类、group use声明。

2020年:PHP 8.0发布

引入JIT、联合类型、匹配表达式、命名参数、构造器属性提升,现代PHP起点。

2022年:PHP 8.2发布

只读属性、随机扩展重构、废弃动态属性,进一步强化类型安全。

2023年:PHP 8.3发布

添加Fibers(轻量级协程)、弱类型数组解构、JSON字符串转常量,持续进化。