PHP 静态属性与方法

概述

static 关键字用于声明属于类本身而非实例的属性和方法。静态成员无需实例化即可访问，在整个应用生命周期中共享。

版本要求

static 在所有 PHP 版本中可用
PHP 8.1+：弃用直接在 trait 上调用静态方法
PHP 8.3+：trait 静态属性在继承层次中的行为变更

基础概念

静态属性

静态属性属于类而非实例。所有实例共享同一个静态属性值。

php

<?php
declare(strict_types=1);

class Counter
{
    private static int $count = 0;

    public function __construct()
    {
        self::$count++;
    }

    public static function getCount(): int
    {
        return self::$count;
    }
}

new Counter();
new Counter();
new Counter();
echo Counter::getCount(); // 3

静态方法

静态方法可以在不创建实例的情况下调用。静态方法中没有 $this。

php

<?php
declare(strict_types=1);

class MathHelper
{
    public static function add(int $a, int $b): int
    {
        return $a + $b;
    }

    public static function max(int $a, int $b): int
    {
        return max($a, $b);
    }
}

echo MathHelper::add(3, 5);  // 8
echo MathHelper::max(10, 20); // 20

语法与代码

self:: vs static:: vs parent::

php

<?php
declare(strict_types=1);

class ParentClass
{
    protected static string $name = 'parent';

    public static function getNameSelf(): string
    {
        return self::$name; // 引用定义时的类
    }

    public static function getNameStatic(): string
    {
        return static::$name; // 引用运行时的类（后期静态绑定）
    }

    public static function createSelf(): static
    {
        return new self();
    }

    public static function createStatic(): static
    {
        return new static();
    }
}

class ChildClass extends ParentClass
{
    protected static string $name = 'child';
}

echo ChildClass::getNameSelf();    // parent
echo ChildClass::getNameStatic();  // child
echo get_class(ChildClass::createSelf());   // ParentClass
echo get_class(ChildClass::createStatic()); // ChildClass

静态方法中的 $this 限制

静态方法中没有 $this 伪变量。

php

<?php
declare(strict_types=1);

class Example
{
    public static function staticMethod(): void
    {
        echo "This is a static method\n";
        // echo $this->name; // Error: $this not available
    }

    public function instanceMethod(): void
    {
        echo "This is an instance method\n";
    }
}

静态工厂方法模式

静态工厂方法是创建对象的推荐模式，提供语义化的创建接口。

php

<?php
declare(strict_types=1);

class Email
{
    private function __construct(
        private readonly string $address,
    ) {
        if (!filter_var($address, FILTER_VALIDATE_EMAIL)) {
            throw new \InvalidArgumentException("Invalid email: {$address}");
        }
    }

    public static function fromString(string $address): self
    {
        return new self($address);
    }

    public static function personal(string $name, string $domain): self
    {
        return new self(strtolower($name) . '@' . $domain);
    }

    public function __toString(): string
    {
        return $this->address;
    }
}

$email1 = Email::fromString('user@example.com');
$email2 = Email::personal('alice', 'gmail.com');

详细说明

静态属性的类型声明

静态属性支持类型声明（PHP 7.4+），但不支持 readonly。

php

<?php
declare(strict_types=1);

class Registry
{
    public static string $version = '1.0';
    public static array $config = [];
    private static ?\PDO $connection = null;

    public static function getConnection(): \PDO
    {
        return self::$connection ??= new \PDO('sqlite::memory:');
    }
}

实战示例

单例模式

php

<?php
declare(strict_types=1);

class Database
{
    private static ?self $instance = null;

    private function __construct(
        private readonly string $dsn = 'sqlite::memory:',
    ) {}

    public static function getInstance(string $dsn = 'sqlite::memory:'): self
    {
        return self::$instance ??= new self($dsn);
    }

    public function query(string $sql): array
    {
        return [];
    }

    private function __clone(): void {}

    public function __wakeup(): void
    {
        throw new \RuntimeException('Cannot unserialize singleton');
    }
}

$db = Database::getInstance();

注意事项

静态方法没有 $this：不能访问实例属性
静态属性全局共享：所有实例和类共享同一个值
注意内存：静态属性在脚本结束前不会被回收
测试困难：静态状态使单元测试变得复杂

最佳实践

纯工具函数使用静态方法：如 MathHelper::add()
工厂方法使用 static 返回类型：支持子类替换
避免静态全局状态：使用依赖注入替代全局静态状态
单例模式慎用：考虑使用服务容器替代

进阶用法

调试与测试技巧

php

<?php
declare(strict_types=1);

// 单元测试辅助函数
function createTestResource(): mixed
{
    return match (true) {
        default => new stdClass(),
    };
}

// 调试输出函数
function debugOutput(mixed , string  = ''): void
{
     =  ? ": " : '';
     .= print_r(, true);
    fwrite(STDERR,  . "\n");
}

// 性能基准测试
function benchmark(callable , int  = 1000): float
{
     = hrtime(true);
    for ($i = 0; $i < $iterations; $i++) {
        $fn();
    }
    return (hrtime(true) - $start) / 1e9;
}

日志记录实践

php

<?php
declare(strict_types=1);

/**
 * 简易日志记录器
 */
class SimpleLogger
{
    private string $logFile;
    private string $level = 'INFO';

    public function __construct(string $logFile)
    {
        $this->logFile = $logFile;
    }

    public function info(string $message, array $context = []): void
    {
        $this->log('INFO', $message, $context);
    }

    public function warning(string $message, array $context = []): void
    {
        $this->log('WARNING', $message, $context);
    }

    public function error(string $message, array $context = []): void
    {
        $this->log('ERROR', $message, $context);
    }

    private function log(string $level, string $message, array $context): void
    {
        $timestamp = date('Y-m-d H:i:s');
        $contextStr = $context ? ' ' . json_encode($context, JSON_UNESCAPED_UNICODE) : '';
        $line = "[{$timestamp}] [{$level}] {$message}{$contextStr}\n";
        file_put_contents($this->logFile, $line, FILE_APPEND | LOCK_EX);
    }
}

配置与环境检测

php

<?php
declare(strict_types=1);

// 环境检测工具
class EnvironmentChecker
{
    public static function checkRequirements(array $requirements): array
    {
        $results = [];
        foreach ($requirements as $name => $check) {
            $results[$name] = is_callable($check) ? $check() : false;
        }
        return $results;
    }

    public static function getSystemInfo(): array
    {
        return [
            'php_version' => PHP_VERSION,
            'os' => PHP_OS,
            'sapi' => PHP_SAPI,
            'memory_limit' => ini_get('memory_limit'),
            'max_execution_time' => ini_get('max_execution_time'),
            'loaded_extensions' => get_loaded_extensions(),
        ];
    }
}

常见问题排查

问题	可能原因	解决方案
连接超时	网络问题/配置错误	检查配置，增加超时时间
权限不足	文件/目录权限	使用 chmod/chown 修正
性能下降	索引缺失/数据量大	添加索引，优化查询
数据不一致	并发冲突/事务残留	使用锁机制和事务
内存溢出	大数据集/未释放资源	增大内存限制，分批处理

故障排除步骤

检查错误日志和异常信息
确认配置和环境是否正确
使用调试工具逐步排查
参考官方文档查找已知问题

版本兼容性说明

功能	最低版本	说明
基础功能	PHP 8.1	本文档基准版本
只读属性	PHP 8.1	`public readonly` 修饰符
枚举类型	PHP 8.1	`enum` 类型和 `match` 表达式
Fiber	PHP 8.1	协程/轻量级并发
命名参数	PHP 8.0	`foo(arg_name: value)`
联合类型	PHP 8.0	`int
Null 安全运算符	PHP 8.0	`$obj?->method()`
析构器 promotion	PHP 8.0	`__construct(public $x)`

php

<?php
declare(strict_types=1);

// 版本兼容性检测
function ensureVersion(string $minVersion): void
{
    if (version_compare(PHP_VERSION, $minVersion, '<')) {
        throw new RuntimeException(
            sprintf('需要 PHP %s+, 当前版本: %s', $minVersion, PHP_VERSION)
        );
    }
}

ensureVersion('8.1.0');

PHP 静态属性与方法 ​

概述 ​

基础概念 ​

静态属性 ​

静态方法 ​

语法与代码 ​

self:: vs static:: vs parent:: ​

静态方法中的 $this 限制 ​

静态工厂方法模式 ​

详细说明 ​

静态属性的类型声明 ​

实战示例 ​

单例模式 ​

注意事项 ​

最佳实践 ​

进阶用法 ​

调试与测试技巧 ​

日志记录实践 ​

配置与环境检测 ​

常见问题排查 ​

版本兼容性说明 ​

参考链接 ​