本文介绍在 Laravel 项目 public/ 目录下运行的非框架脚本（如裸 PHP 页面）中，手动加载 .env 文件并正常使用 env() 函数的方法，无需启动 Laravel 生命周期，仅依赖 vlucas/phpdotenv 库即可实现。
本文介绍在 laravel 项目 `public/` 目录下运行的非框架脚本（如裸 php 页面）中，手动加载 `.env` 文件并正常使用 `env()` 函数的方法，无需启动 laravel 生命周期，仅依赖 `vlucas/phpdotenv` 库即可实现。
在 Laravel 应用中，.env 变量可通过 env('KEY') 直接调用，这是因为 Laravel 启动时通过 Dotenv\Dotenv 自动解析 .env 并写入 $_ENV 和 $_SERVER。但当你在 public/ 下创建一个独立 PHP 文件（例如 cron-handler.php 或 health-check.php），并直接通过 Web 服务器访问或 CLI 执行时，Laravel 的引导流程并未触发，env() 函数将返回 null 或默认值——因为底层 $_ENV 尚未被填充。
解决方法是手动初始化 dotenv 加载器，复用 Laravel 项目已安装的 vlucas/phpdotenv（Laravel 默认依赖）。关键步骤如下：
- 引入自动加载器：确保能使用 Composer 包；
- 指定 .env 文件路径：通常位于项目根目录（即 public/ 的上级目录）；
- 构建 Repository 并安全加载：使用 RepositoryBuilder 和 Dotenv::create() 显式加载；
- 之后即可正常使用 env()：函数行为与 Laravel 内完全一致。
以下是完整、可直接部署的示例代码（建议保存为 public/env-test.php）：
<?php // public/env-test.php
require_once __DIR__ . '/../vendor/autoload.php';
use Dotenv\Dotenv;
use Dotenv\Repository\RepositoryBuilder;
// 构建环境变量仓库（支持覆盖、只读等策略，此处使用默认配置）
$repository = RepositoryBuilder::create()->make();
// 创建 Dotenv 实例：指向项目根目录（.env 所在位置），文件名为 .env
$dotenv = Dotenv::create($repository, __DIR__ . '/..', '.env');
// 安全加载（不抛异常，跳过缺失文件或语法错误）
$dotenv->safeLoad();
// ✅ 此时 env() 已可用
$appName = env('APP_NAME', 'Laravel App');
$debug = env('APP_DEBUG', false);
$databaseHost = env('DB_HOST', '127.0.0.1');
?>
<meta charset="UTF-8"><title>.env Test</title><h2>Loaded from .env:</h2>
- APP_NAME: = htmlspecialchars($appName) ?>
- APP_DEBUG: = $debug ? 'true' : 'false' ?>
- DB_HOST: = htmlspecialchars($databaseHost) ?>
✅ 注意事项：
- 确保 vendor/vlucas/phpdotenv 已安装（Laravel 项目默认存在，无需额外 composer require）；
- 路径 __DIR__ . '/..' 表示从 public/ 回退到项目根目录——请根据实际 .env 位置调整（如部署在子目录需修正）；
- 始终使用 safeLoad() 而非 load()，避免因 .env 临时缺失导致脚本崩溃；
- env() 函数本身由 Laravel 的 helpers.php 提供（位于 vendor/laravel/framework/src/Illuminate/Support/helpers.php），该文件会在 autoload.php 中自动引入，因此无需手动 require；
- 生产环境切勿在公开脚本中输出敏感变量（如 DB_PASSWORD），本例仅为验证用途。
通过以上方式，你既能保持脚本轻量、脱离 Laravel 生命周期，又能无缝复用项目统一的环境配置，兼顾灵活性与安全性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
