php变量名必须以$开头、不能数字开头、区分大小写且禁用保留字;推荐snake_case命名,避免动态变量和超全局误用。

PHP变量名必须以美元符开头,且不能用数字打头
PHP里没有“声明”这回事——$name第一次出现就是声明,不加var、let或type。但名字得合规,否则直接报错:Parse error: syntax error, unexpected '123'。
常见错误是写成my_var(漏了$)或者$123abc(数字开头)。PHP解析器看到123abc会以为是数字字面量,紧接着字母就语法爆炸。
-
$user_id✅ 合法:下划线分隔,小写字母开头 -
$User✅ 合法:大小写敏感,$user和$User是两个变量 -
$_config✅ 合法:以下划线开头,常用于内部变量 -
$this❌ 非法:这是保留关键字,不能当普通变量名用 -
$user-name❌ 非法:短横线会被当作减号运算符,解析成$user - name
下划线 vs 驼峰命名:选一个,别混着来
PHP本身不限制风格,但PSR-12编码规范明确推荐snake_case(下划线),尤其在变量、函数、方法名上。混用比如$userName和$user_id在团队协作中容易引发歧义,IDE自动补全也容易出错。
更实际的问题是:有些框架(如Laravel的Eloquent)默认把数据库字段created_at映射为$createdAt,但这是ORM层做的转换,底层变量仍是$created_at。如果你手动写$createdAt又没配好访问器,值就拿不到。
立即学习“PHP免费学习笔记(深入)”;
- 函数参数、局部变量、数组键统一用
$data_source这类写法 - 类属性如果要兼容JSON序列化或API输出,注意
json_encode()不会自动转驼峰 - 避免
$User_Name这种大小写+下划线混合——既难读,又容易因大小写疏忽导致undefined variable
动态变量名($$)很危险,99%的情况不该用
写$$var确实能间接取值,比如$key = 'name'; $name = 'Alice'; echo $$key;输出Alice。但它绕过了静态分析,IDE无法跳转,PHPStan/PHP_CodeSniffer直接报DynamicVariableUsage警告。
真实场景里,它常出现在拼SQL字段、批量赋值或模板渲染中,结果是:变量名拼错就静默失败,调试时只能var_dump(get_defined_vars())硬翻。
- 替代方案优先用数组:
$data['name']比$$name清晰可控 - 如果真要反射式赋值,用
ReflectionProperty或__set()魔法方法,至少有类型约束 -
extract($array)本质也是动态变量生成,同样被主流代码规范禁用
超全局变量不是普通变量,别试图“重新声明”
$_GET、$_POST这些不是你定义的,是PHP预设的超全局符号表。写$_GET = []看似清空,其实只是覆盖当前作用域副本;后续脚本再读$_GET还是原始值(除非你用unset($_GET),但这也只影响当前请求生命周期)。
更隐蔽的坑是:在函数里直接改$_SESSION,比如$_SESSION['user'] = null,看起来删了用户信息,但如果session未start或已过期,这个赋值根本不会落地到存储后端。
- 读取前先判断是否存在:
isset($_POST['email']),别直接$_POST['email'],否则触发Notice: Undefined index - 不要用
$GLOBALS['HTTP_POST_VARS']这种废弃写法,PHP 5.0之后就该用$_POST -
$_ENV默认为空,除非启用了variables_order配置,别假设它总有值
变量名看着是小事,但PHP不校验类型、不强制声明、运行时才暴露问题——名字一旦起错,debug成本远高于重命名本身。











