php静态变量的phpdoc注释需按上下文区分：类中静态属性应在声明前用/* @var 类型 /注释；函数内static变量须在声明行用// @var 类型注释，或php 7.4+直接类型声明。
PHP静态变量怎么写PHPDoc注释
PHP静态变量本身不支持直接在声明时用/** */块注释（比如static $cache = [];上方加文档块），PHPDoc标准不识别这种上下文。必须把注释写在能被解析器捕获的位置——通常是变量所属的类属性声明处，或函数/方法内static变量的首次定义行上方，且需明确标注类型。
类中静态属性的正确PHPDoc写法
类内的static属性属于类成员，可被PHPDoc工具（如PHPStan、IDE）识别。关键点：注释必须紧贴属性声明前，且用@var标明类型，不能省略static关键字修饰符的语义暗示。
/** * 缓存已处理过的用户ID，避免重复计算 * @var array<int, string> */ public static $processedUsers = [];
- 类型必须写全，如
array<int string></int>，不能只写array（PHPStan会报错） - 如果属性是
private或protected，同样适用，但IDE补全可能受限 - 不要写
@static——这不是标准PHPDoc标签，会被忽略
函数内static变量如何注释才有效
函数作用域里的static变量（如function counter() { static $count = 0; }）无法被PHPDoc工具自动提取，但可通过在变量声明**同一行**用//注释 + 类型提示（PHP 7.4+）来保障可读性和类型安全：
YXPHP企业网站管理系统4.0
下载
支持静态模板,支持动态模板标签,支持图片.SWF.FLV系列广告标签.支持百万级海量数据,绑定内置URL伪装策略(URL后缀名随你怎么写)，绑定内置系统升级策略(暂不开放升级),绑定内置模板付费升级策略(暂不开放更新)。支持标签容错处理,绑定内置攻击防御策略,绑定内置服务器优化策略(系统内存释放的干干净净)。支持离线运行,支持次目录,兼容U主机。支持会员功能,支持文章版块权限阅读,支持会员自主注册
function getRetryDelay() {
// @var int 延迟毫秒数，每次失败后指数增长
static $delay = 100;
$delay *= 2;
return $delay;
}- 不能把
/** */写在static $delay = 100;上方——PHP Parser不会将其关联到该变量 - PHP 7.4+ 支持
static int $delay = 100;，此时类型已显式声明，注释可侧重说明业务逻辑 - 若用
declare(strict_types=1)，类型提示还能参与运行时校验
为什么@var注释有时不生效
常见失效原因不是语法错，而是位置或上下文不匹配：
立即学习“PHP免费学习笔记（深入）”；
- 注释写在
static变量赋值语句之后（如static $x = 1; // @var int）→ IDE和静态分析器完全忽略 - 在匿名函数或闭包里声明
static变量，且未启用phpstan/phpstan-phpunit等扩展 → 类型推断失败 - 使用
eval()或动态变量名（如static ${'cache_'.$type} = [];）→ 任何注释都无效，类型只能靠运行时断言 - PHPStorm里未开启「PHPDoc type checking」检查项 → 注释存在但不报类型警告
静态变量的“持久性”来自执行生命周期，不是语言层面的常量；它的注释难点恰恰在于这种隐式作用域——既不属于类，也不属于全局，得靠人眼和约定去维护类型一致性。
