0Pricing
PHP Academy · 课时

环境变量与 .env 文件

在 PHP 中使用 .env 文件和 dotenv 库管理敏感配置。

环境变量与 .env 文件 是 CoddyKit 上的免费 PHP Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

为什么使用环境变量

将凭据或特定环境的配置硬编码到源代码中既不安全，也会使部署变得脆弱。环境变量可以将配置与代码分离。

.env 文件

.env 文件包含在启动时加载到环境中的键值对。请将其添加到 .gitignore 中——NEVER 将它提交到版本控制系统。

# .env
APP_ENV=production
APP_KEY=base64:...
DB_HOST=127.0.0.1
DB_NAME=myapp
DB_USER=myapp_user
DB_PASS=supersecret

REDIS_HOST=127.0.0.1
MAIL_HOST=smtp.mailtrap.io

Laravel .env 集成

Laravel 使用 vlucas/phpdotenv 自动加载 .env。请通过 env() 辅助函数访问其中的值。

<?php
$host = env("DB_HOST", "127.0.0.1"); // "127.0.0.1" is the default

config() 与 env()

请仅在 config/*.php 文件中使用 env()。在其他任何地方，请使用 config("database.host")，这样才能与配置缓存正确配合。

<?php
// In config/database.php:
"host" => env("DB_HOST", "127.0.0.1")

// In your service classes:
$host = config("database.connections.mysql.host");

缓存配置

在生产环境中请缓存配置，以免每次请求都解析 .env。

$ php artisan config:cache
# After changing .env:
$ php artisan config:clear

使用 phpdotenv 的原生 PHP

在 Laravel 之外，请使用 vlucas/phpdotenv。

$ composer require vlucas/phpdotenv

<?php
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
$host = $_ENV["DB_HOST"];

必需的变量

请在启动时强制检查必需的环境变量，以便尽早发现缺失的配置。

<?php
$dotenv->required(["DB_HOST", "DB_NAME", "DB_USER", "DB_PASS"]);
$dotenv->required(["DB_PORT"])->isInteger();

.env.example 文件

请提交一个包含所有变量名称但不包含任何值的 .env.example 文件。开发者将其复制为 .env，然后填入自己的值。

服务器级环境变量

在生产环境中，请在服务器级别设置环境变量（systemd 服务文件、Docker 的 --env 标志、Kubernetes 密钥），而不要使用 .env 文件。

# systemd service:
[Service]
Environment="APP_ENV=production"
Environment="DB_HOST=db.internal"

密钥管理

对于敏感凭据（API 密钥、证书），可以考虑使用密钥管理器：HashiCorp Vault、AWS Secrets Manager，或用于 CI 的 GitHub Actions secrets。

总结

请将所有特定环境的配置存储在 .env 中。切勿提交它。请在应用程序代码中使用 config()，仅在配置文件中使用 env()。在生产环境中使用 php artisan config:cache 缓存配置。

快速检查

在 Laravel 应用程序中，应在哪里调用 env()？

常见问题解答

「环境变量与 .env 文件」课时是免费的吗？

是的 — 「环境变量与 .env 文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「环境变量与 .env 文件」这节课中我会学到什么？

在 PHP 中使用 .env 文件和 dotenv 库管理敏感配置。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。

「环境变量与 .env 文件」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. Nginx 与 PHP-FPM 配置
  2. 环境变量与 .env 文件
  3. 使用 GitHub Actions 部署
  4. 将 PHP 应用容器化
← 返回 PHP Academy