php文件模板需在“editor → file and code templates → files”中修改php class/interface/trait项，而非php file；其变量如${name}、${namespace}须严格按velocity语法书写，错误将导致静默失效。
PHP文件模板在哪改
PhpStorm 的 PHP 文件模板不是在“编辑器 → 文件和代码模板”里随便选个 PHP 就能直接改的——默认的 PHP File 模板只影响通过 右键 → New → PHP File 创建的空文件，不参与 class、interface、trait 等结构化文件生成。真要统一控制新类/接口的骨架，得去改对应的语言结构模板。
修改 class/interface/trait 模板内容
进入 Settings / Preferences → Editor → File and Code Templates → Files，找到以下几项：
-
PHP Class：控制New → PHP Class生成的内容（含命名空间、class声明、括号换行等） -
PHP Interface：同理，影响接口定义格式 -
PHP Trait：决定 trait 文件初始结构
这些模板支持内置变量，比如 ${NAME}（文件名）、${NAMESPACE}（当前目录对应的命名空间）、${DATE}。别手动删 namespace 行——如果项目用 PSR-4 自动加载，没声明命名空间会导致自动补全失效或 Class not found 错误。
#if (${NAMESPACE} != "")namespace ${NAMESPACE};#end
<h1>if (${NAMESPACE} != "")#set( $NAMESPACE_BLOCK = "${NAMESPACE}\")#else#set( $NAMESPACE_BLOCK = "")#end</h1><p>class ${NAME}
{
}为什么改了模板但新建文件没生效
常见原因有三个：
立即学习“PHP免费学习笔记（深入）”；
发卡宝是一个专业的软件卡密等虚拟商品在线交易平台,拥有多种兑换方式,费率低,结算快,正规企业平台一直稳定运营,24小时不间断提供自动发卡服务。【模板说明】试用版自带一套模板（响应式）【环境支持】PHP环境 / 200M或以上空间大小 / 开启父路径 / 设置index.php为默认首页 / 目录写入权限需要开启【数据库】MySQL【安装步骤】将文件上传至空间目录，运行“http://域名/inst
- 新建的是普通
.php文件（走的是PHP File模板），不是通过New → PHP Class创建的——后者才读PHP Class模板 - 模板里用了错误的变量名，比如写成
$NAME（少一个{}），PhpStorm 会静默忽略，渲染成空白或字面量 - 项目启用了
PHP Language Level低于 7.0，某些模板语法（如declare(strict_types=1)）会被自动过滤掉
验证方式：在模板里临时加一行 // debug: ${NAME}，新建类看是否出现——没出现就说明模板根本没被调用。
自定义模板加常用代码片段
想让每个新 class 都自动带 __construct 或 DocBlock？直接往 PHP Class 模板里加：
class ${NAME}
{
/**
* @var
*/
private \$${NAME?lower};
<pre class='brush:php;toolbar:false;'>public function __construct()
{
}}
注意：\$${NAME?lower} 中的反斜杠是转义，否则 $name 会被当作模板变量解析失败；${NAME?lower} 是 Velocity 模板语法，表示小写转换。如果项目强制要求 strict_types，建议在 PHP Class 模板顶部加 declare(strict_types=1);，但需确认全局 PHP 版本支持。
模板变量不会自动补全，拼错就白改。最稳妥的方式是复制已有模板内容，再局部调整——别从零手敲。
