PHP 范围解析操作符 ::

概述

范围解析操作符 ::（也称双冒号、Paamayim Nekudotayim）用于访问类的静态成员、常量和重写的方法。它是 PHP OOP 中进行类级别操作的核心操作符。

基础概念

用途

:: 操作符用于以下场景：

访问类常量：ClassName::CONSTANT
访问静态属性：ClassName::$property
访问静态方法：ClassName::method()
调用父类方法：parent::method()
访问当前类：self::CONSTANT
后期静态绑定：static::method()

语法与代码

访问类常量

php

<?php
declare(strict_types=1);

class HttpCodes
{
    public const OK = 200;
    public const NOT_FOUND = 404;

    public function getOkCode(): int
    {
        return self::OK;
    }
}

echo HttpCodes::OK; // 200

访问静态属性和方法

php

<?php
declare(strict_types=1);

class AppSettings
{
    private static string $env = 'production';

    public static function setEnv(string $env): void
    {
        self::$env = $env;
    }

    public static function getEnv(): string
    {
        return self::$env;
    }
}

AppSettings::setEnv('development');
echo AppSettings::getEnv(); // development

self:: vs static:: vs parent::

php

<?php
declare(strict_types=1);

class Animal
{
    protected static string $sound = '...';

    public static function makeSoundSelf(): string
    {
        return self::$sound; // 始终指向 Animal
    }

    public static function makeSoundStatic(): string
    {
        return static::$sound; // 运行时绑定
    }

    public static function describe(): string
    {
        return static::class . ' says ' . static::makeSoundStatic();
    }
}

class Dog extends Animal
{
    protected static string $sound = 'Woof';
}

class Cat extends Animal
{
    protected static string $sound = 'Meow';
}

echo Dog::makeSoundSelf();   // ...
echo Dog::makeSoundStatic(); // Woof
echo Dog::describe();        // Dog says Woof
echo Cat::describe();        // Cat says Meow

parent:: 调用父类

php

<?php
declare(strict_types=1);

class Vehicle
{
    public function describe(): string
    {
        return 'A generic vehicle';
    }
}

class Car extends Vehicle
{
    public function describe(): string
    {
        $parentDesc = parent::describe();
        return "{$parentDesc} with 4 wheels";
    }
}

$car = new Car();
echo $car->describe(); // A generic vehicle with 4 wheels

后期静态绑定与 :: 的关系

static:: 实现后期静态绑定，运行时才确定引用的类。self:: 在编译时确定。

php

<?php
declare(strict_types=1);

class Repository
{
    public static function create(): static
    {
        return new static();
    }

    public static function tableName(): string
    {
        return 'repository';
    }

    public static function find(int $id): ?static
    {
        $table = static::tableName();
        echo "SELECT * FROM {$table} WHERE id = {$id}\n";
        return null;
    }
}

class UserRepository extends Repository
{
    public static function tableName(): string
    {
        return 'users';
    }
}

UserRepository::find(1); // SELECT * FROM users WHERE id = 1
echo get_class(UserRepository::create()); // UserRepository

详细说明

::class 常量

ClassName::class 在编译时解析为完全限定类名（FQCN）。

php

<?php
declare(strict_types=1);

namespace App\Services;

class UserService
{
}

echo UserService::class; // App\Services\UserService

// PHP 8.0+：也适用于对象
$service = new UserService();
echo $service::class; // App\Services\UserService

// 类不存在也能解析
echo NonExistent::class; // NonExistent

外部访问静态成员

$ 符号在访问静态属性时必须使用。

php

<?php
declare(strict_types=1);

class Config
{
    public static string $appName = 'MyApp';

    public static function version(): string
    {
        return '1.0.0';
    }
}

// 属性需要 $ 符号
echo Config::$appName;    // MyApp
// echo Config::appName;  // Fatal error（当作常量处理）

// 方法不需要 $ 符号
echo Config::version();   // 1.0.0

实战示例

活动记录模式

php

<?php
declare(strict_types=1);

abstract class Model
{
    protected static string $table = '';

    public static function all(): array
    {
        $table = static::$table;
        echo "SELECT * FROM {$table}\n";
        return [];
    }

    public static function findById(int $id): ?static
    {
        $table = static::$table;
        echo "SELECT * FROM {$table} WHERE id = {$id}\n";
        return null;
    }
}

class Post extends Model
{
    protected static string $table = 'posts';
}

class Comment extends Model
{
    protected static string $table = 'comments';
}

Post::all();       // SELECT * FROM posts
Post::findById(1); // SELECT * FROM posts WHERE id = 1
Comment::all();    // SELECT * FROM comments

注意事项

静态属性使用 $：ClassName::$property，忘记 $ 会报错
self:: 是编译时绑定：始终指向定义类
static:: 是运行时绑定：指向调用时的类
parent:: 仅限子类使用：在类外部调用没有意义

最佳实践

访问常量用 self::：常量不会被覆盖（除非非 final）
实例创建用 static::：支持后期静态绑定
子类调用父类用 parent::：保持继承链完整性
获取类名用 ::class：比 get_class() 更可靠
工厂方法返回 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:: ​

parent:: 调用父类 ​

后期静态绑定与 :: 的关系 ​

详细说明 ​

::class 常量 ​

外部访问静态成员 ​

实战示例 ​

活动记录模式 ​

注意事项 ​

最佳实践 ​

进阶用法 ​

调试与测试技巧 ​

日志记录实践 ​

配置与环境检测 ​

常见问题排查 ​

版本兼容性说明 ​

参考链接 ​