只需修改Settings → Editor → File and Code Templates → Files → PHP File模板，变量必须严格用${xxx}格式（如${DATE}），改完需重启IDE生效；PHP File Header.php在Includes中无效，批量更新版权年份须用Copyright功能而非搜索替换。
PHP File模板在哪改、变量怎么写才生效
新建.php文件时自动带版权声明，只改Settings → Editor → File and Code Templates → Files → PHP File这一处就行，其他地方动了都不管用。模板里必须用${DATE}（不是$DATE$，也不是${YEAR}），格式固定为2026-07-01，每天新建都会自动更新。所有变量都得严格套${xxx}，多一个空格、少一个$或{}，就原样输出字符串。
推荐直接复制进模板顶部：
/**\n * @package ${NAMESPACE}\n * @author $USER$\n * @created ${DATE} ${TIME}\n * @copyright Copyright ${DATE.substring(0, 4)} $USER$\n */-
${NAMESPACE}依赖项目是否标记了Sources Root：右键src/目录 →Mark Directory as → Sources Root，否则永远为空 -
$USER$取系统登录名；想用git config --get user.name，得加VM参数-Dgit.user.name=$(git config --get user.name)，重启后用$git_user_name$ - 改完必须点
Apply，只点OK不保存
为什么改了PHP File Header没反应
PHP File Header.php是Includes分类下的模板，它本身不控制新建文件行为。默认PHP File模板是空的，没写#parse("PHP File Header.php")，所以你改Includes里的内容完全不影响新建文件。
想复用头部结构，两个选择：
立即学习“PHP免费学习笔记（深入）”；
- 把注释块直接粘贴进
PHP File模板正文顶部（最简单、最可靠） - 如果坚持用
#parse，被引用的文件必须也在Files分类下，且#parse("PHP File Header.php")必须放在PHP File模板最开头（甚至在<?php前）
别把PHP File Header.php建在Includes里再指望它生效——那是给类模板用的，和新建文件无关。
批量更新旧文件版权年份不能靠搜索替换
已有文件里的Copyright 2025不会自动变成2026，搜替换容易误伤字符串或注释外内容。得用PhpStorm内置的Copyright功能，它基于Scope和正则匹配精准定位。
- 先建
Scope：进入Settings → Editor → Copyright → Scopes，新增如team-src，路径填src/**或app/**/*.php，别用**全局匹配 - 再配
Notice Text：在Copyright Profiles里设正则Copyright\s+\d{4}，只匹配年份部分 - 关联并执行：把Profile拖到Scope下方，右键目标目录 →
Update Copyright
这个操作只改注释块内符合正则的那一行，不会碰代码逻辑或非版权行。
改完模板不重启IDE，变量还是原样输出
这是最隐蔽也最常被忽略的问题：${DATE}、${NAMESPACE}这些变量改完后不重启PhpStorm，旧缓存会继续输出字面量，比如生成文件里出现${DATE}而不是2026-07-01。这不是报错，是静默失败，看着像配置没生效。
尤其当你从Includes挪模板到Files、或刚加了-Dgit.user.name参数时，必须彻底关闭再重开IDE，否则变量解析机制不会刷新。
另外，Git用户名这类VM参数只在启动时读取一次，之后改了git config也得重启才能同步。
