首先在.env文件中添加自定义变量，如APP_MAINTENANCE_MODE=false；接着通过env()函数读取变量值，并将其注入config/invoice.php等配置文件中；最后执行php artisan config:clear清除缓存以使更改生效。

如果您希望在 Laravel 项目中扩展配置功能，可以通过在 .env 文件中添加自定义变量来实现环境级别的动态设置。这些变量可用于控制调试行为、API 密钥、业务开关等场景。

本文运行环境：MacBook Pro，macOS Sonoma

一、在 .env 文件中定义自定义变量

此步骤用于在项目根目录的 .env 文件中声明新的环境变量，Laravel 会自动加载这些变量到 $_ENV 和 $_SERVER 中，供 config 文件调用。

1、打开项目根目录下的 .env 文件。

2、在文件末尾添加自定义变量，格式为 KEY=VALUE，例如：

APP_MAINTENANCE_MODE=false

INVOICE_PREFIX=INV-

MAX_UPLOAD_SIZE=2048

3、保存并关闭文件。

二、通过 env() 函数读取自定义变量

env() 是 Laravel 提供的辅助函数，用于从 .env 文件中读取变量值。如果变量不存在，可提供默认值作为备选。

1、在任意 PHP 文件中使用 env() 函数获取变量，例如：

$maintenanceMode = env('APP_MAINTENANCE_MODE', false);

$prefix = env('INVOICE_PREFIX', 'DEFAULT-');

2、注意：不建议在控制器或路由中直接调用 env()，应通过配置文件间接引用。

三、将自定义变量注入配置文件

为了符合 Laravel 最佳实践，应将 .env 变量映射到 config 目录下的配置文件中，以便在应用中统一管理。

1、创建新的配置文件，如 config/invoice.php，内容如下：

return [

'prefix' => env('INVOICE_PREFIX', 'INV-'),

'max_size' => env('MAX_UPLOAD_SIZE', 1024),

];

2、在代码中通过 config('invoice.prefix') 获取值：

$prefix = config('invoice.prefix');

四、清除配置缓存以生效修改

Laravel 在生产环境中会缓存配置，因此修改 .env 或配置文件后需手动清除缓存，否则新变量可能无法被识别。

1、执行 Artisan 命令清除配置缓存：

php artisan config:clear

2、重新生成配置缓存（部署时使用）：

php artisan config:cache

3、开发过程中可使用 php artisan serve 自动加载最新配置。