.env文件是PHP项目中用于存储环境变量的纯文本文件，通过键值对形式管理配置，如数据库连接、API密钥等，提升安全性与可维护性。文件位于项目根目录，格式为KEY=VALUE，不应提交至版本控制，需加入.gitignore，并提供.env.example模板。Laravel内置支持，使用vlucas/phpdotenv库自动加载，通过env()函数访问变量，修改后需清除缓存。Symfony通过symfony/dotenv组件加载，在入口文件中引入并解析，推荐在services.yaml中引用环境变量。通用最佳实践包括：避免直接调用getenv()，通过配置层抽象访问；生产环境优先使用服务器环境变量；不存储复杂数据结构；确保本地与生产配置一致性，便于CI/CD集成。
在PHP开发中，环境变量是管理不同运行环境（如开发、测试、生产）配置的核心方式。通过使用.env文件，可以将数据库连接、API密钥、调试开关等敏感或易变的配置与代码分离，提升安全性与可维护性。主流PHP框架如Laravel、Symfony等都原生支持或可通过组件实现.env文件管理。
什么是.env文件？
.env文件是一个纯文本文件，通常位于项目根目录，用于存储键值对形式的环境变量。每一行定义一个变量，格式为KEY=VALUE。例如：
DB_HOST=localhost
DB_USER=root
DB_PASS=secret123
CACHE_DRIVER=redis
该文件不应提交到版本控制系统（如Git），避免泄露敏感信息。一般通过.gitignore排除，并提供.env.example作为模板供团队参考。
Laravel中的环境变量配置
Laravel内置了对.env文件的支持，使用vlucas/phpdotenv库自动加载变量。
立即学习“PHP免费学习笔记（深入）”；
- 项目启动时，Laravel会自动读取根目录下的.env文件
- 变量通过
env()函数或config辅助函数访问- 实际配置应写入
config/目录下的文件，例如：# config/database.php
'mysql' => [
'host' => env('DB_HOST', '127.0.0.1'),
]
修改.env后需清除配置缓存：php artisan config:clearphp artisan cache:clear
Symfony中使用Dotenv组件
Symfony默认使用symfony/dotenv组件加载环境变量。配置步骤如下：
- 确保已安装
symfony/dotenv（现代版本通常已包含） - 在
public/index.php或内核引导文件中启用：
$dotenv->loadEnv(__DIR__.'/.env');
之后可在配置文件或服务中通过$_ENV或getenv()获取变量。Symfony推荐在config/services.yaml中引用：
database_host: '%env(DB_HOST)%'
通用最佳实践
无论使用何种框架，以下做法能提升配置管理质量：
- 始终将
.env加入.gitignore，防止密钥泄露 - 提供
.env.example文件，列出所需变量结构 - 不要在代码中直接调用
getenv()或$_ENV，应通过配置层抽象访问 - 生产环境建议通过服务器环境变量设置，而非依赖
.env文件（更安全） - 避免在
.env中存储复杂结构数据，如数组或JSON，应拆解为扁平键
基本上就这些。合理使用.env文件能让PHP应用更灵活、安全，也便于CI/CD流程集成。关键是把配置和代码彻底分离，同时保证本地与生产环境的一致性。
