本文介绍在 Laravel 项目中，如何让位于 public 目录下、不经过 Laravel 生命周期的独立 PHP 脚本（如纯 PHP 页面）安全读取 .env 文件中的环境变量，无需启动 Laravel 应用即可使用 env() 函数。
本文介绍在 laravel 项目中，如何让位于 public 目录下、不经过 laravel 生命周期的独立 php 脚本（如纯 php 页面）安全读取 `.env` 文件中的环境变量，无需启动 laravel 应用即可使用 `env()` 函数。
Laravel 的 env() 辅助函数本身并不直接读取 .env 文件，而是从已注入的 $_ENV 或 $_SERVER 超全局数组中获取值。真正完成 .env 解析与加载的是 vlucas/phpdotenv 组件——它在 Laravel 启动时由框架自动调用。当脚本绕过 Laravel 生命周期（例如直接访问 public/standalone.php），该加载过程不会触发，因此 env() 返回 null 或默认值。
要解决此问题，需在独立脚本中手动初始化 Dotenv 实例，显式加载 .env 文件，并确保其内容写入 $_ENV（从而兼容 Laravel 的 env() 函数）。以下是推荐实现方式：
✅ 正确加载步骤（Laravel 9+ / Dotenv v5+）
<?php // public/standalone.php
require_once __DIR__ . '/../vendor/autoload.php';
use Dotenv\Dotenv;
use Dotenv\Repository\RepositoryBuilder;
// 1. 创建 Repository（控制变量作用域与覆盖策略）
$repository = RepositoryBuilder::create()
->immutable() // 禁止运行时修改已加载变量（推荐）
->nesting(false) // 关闭嵌套解析（避免意外行为）
->make();
// 2. 初始化 Dotenv 实例：指定 .env 所在路径（通常为项目根目录）
$dotenv = Dotenv::create($repository, __DIR__ . '/..', '.env');
// 3. 安全加载（不抛异常，跳过缺失文件；生产环境建议用 load() 并捕获异常）
$dotenv->safeLoad();
// ✅ 此时 env() 已可用（Laravel 的 helpers.php 中定义，autoload 后即生效）
?>
<title>独立脚本</title><h1><?php echo env('APP_NAME', 'Laravel App'); ?></h1>
<p>调试环境: <?php echo env('APP_DEBUG', 'false'); ?></p>
⚠️ 关键注意事项
- 路径必须准确：__DIR__ . '/..' 表示从 public/ 上溯至项目根目录（即 .env 所在位置），请根据实际部署结构调整；
- 依赖已安装：确保 vlucas/phpdotenv 已通过 Composer 安装（Laravel 默认包含，无需额外 require）；
- 不要在生产环境使用 safeLoad()：它会静默忽略错误（如权限不足、文件不存在）。生产环境应改用 $dotenv->load() 并配合 try-catch 处理异常；
- 安全性提醒：切勿将 .env 文件置于 Web 可访问路径（如 public/.env）；Laravel 默认将其放在项目根目录，且 Web 服务器（Nginx/Apache）已配置禁止访问，务必确认该规则生效；
- 避免重复加载：若脚本可能被多次包含，建议加判断防止重复初始化（如 if (!defined('DOTENV_LOADED')) { ...; define('DOTENV_LOADED', true); }）。
通过以上方式，你既能保持脚本轻量、隔离于 Laravel 核心流程，又能无缝复用 Laravel 的环境变量体系，兼顾灵活性与一致性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
