• Nilai Konfigurasi Akses
  • Konfigurasi Cache
  • Maintenance Mode
  • Introductionall Files Konfigurasi Rangka Kerja Laravel disimpan dalam Direktori Config . Setiap pilihan diterangkan dan anda boleh menyemak fail ini pada bila-bila masa untuk membiasakan diri dengan pilihan konfigurasi yang tersedia untuk anda.
• Konfigurasi Persekitaran
Untuk persekitaran di mana aplikasi dijalankan, selalunya berguna untuk mempunyai konfigurasi yang berbeza untuk persekitaran yang berbeza. Sebagai contoh, anda mungkin mahu menggunakan pemacu cache yang berbeza secara tempatan daripada yang digunakan oleh pelayan pengeluaran.
• Laravel menggunakan perpustakaan PHP Vance Lucas DotEnv untuk menjadikan pelaksanaan ciri ini sangat mudah. Dalam aplikasi Laravel yang baru dipasang, direktori akarnya akan mengandungi fail .env.example. Jika Laravel dipasang melalui Komposer, fail ini akan dinamakan semula secara automatik kepada .env. Jika tidak, anda perlu menukar nama fail secara manual.
Fail .env anda tidak seharusnya ditumpukan kepada sistem kawalan sumber aplikasi anda, kerana setiap pembangun/pelayan yang menggunakan aplikasi anda mungkin perlu mempunyai konfigurasi persekitaran yang berbeza. Selain itu, sekiranya penceroboh mendapat akses kepada repositori kawalan sumber anda, ini menjadi risiko keselamatan kerana sebarang bukti kelayakan sensitif terdedah.
• Jika anda membangun sebagai satu pasukan, anda mungkin masih mahu memasukkan fail .env.example dalam aplikasi anda. Kerana dengan meletakkan nilai pemegang tempat dalam fail konfigurasi sampel, pembangun lain dalam pasukan dapat melihat dengan jelas pembolehubah persekitaran yang diperlukan untuk menjalankan aplikasi. Anda juga boleh membuat fail .env.testing yang akan menimpa apabila menjalankan ujian PHPUnit atau melaksanakan perintah Artisan dengan pilihan --env=testing Nilai dalam fail .env.

{tip} Semua pembolehubah dalam fail .env boleh ditindih oleh pembolehubah persekitaran luaran (seperti pembolehubah persekitaran peringkat pelayan atau peringkat sistem).

Jenis pembolehubah persekitaran

(null) (null) null

Jika anda perlu menentukan pembolehubah persekitaran dengan nilai yang mengandungi ruang, anda boleh melakukannya dengan melampirkan nilai dalam petikan berganda.

APP_NAME="我的 应用"

Dapatkan semula konfigurasi persekitaran

Apabila aplikasi menerima permintaan, semua pembolehubah yang disenaraikan dalam fail .env akan dimuatkan ke dalam pembolehubah super global PHP $ _ENV dalam. Anda boleh mendapatkan semula nilai pembolehubah ini menggunakan fungsi env. Malah, jika anda melihat fail konfigurasi Laravel, anda akan dapati bahawa beberapa pilihan sudah menggunakan fungsi ini: .env 文件中列出的所有变量将被加载到 PHP 的超级全局变量 $ _ENV 中。你可以使用 env 函数检索这些变量的值。事实上，如果你查看 Laravel 的配置文件，你就能注意到有数个选项已经使用了这个函数：

'debug' => env('APP_DEBUG', false),

传递给 env 函数的第二个值是「默认值」。如果给定的键不存在环境变量，则会使用该值。

确定当前环境

应用程序当前所处环境是通过 .env 文件中的 APP_ENV 变量确定的。你可以通过 App facade 中的 environment 方法来访问此值：

$environment = App::environment();

你还可以传递参数给 environment 方法，以检查当前的环境配置是否与给定值匹配。 如果与给定值匹配，该方法将返回 true：

if (App::environment('local')) {  
  // 当前环境是 local
  }
if (App::environment(['local', 'staging'])) {  
  // 当前的环境是 local 或 staging...
  }

{tip} 应用程序当前所处环境检测可以被服务器级的 APP_ENV 环境变量覆盖。这在为相同的应用程序配置不同的环境时是非常有用的，这样你可以在你的服务器配置中为给定的主机设置与其匹配的给定的环境。

在调试页面隐藏环境变量

当一个异常未被捕获并且 APP_DEBUG 环境变量为 true 时，调试页面会显示所有的环境变量和内容。在某些情况下你可能想隐藏某些变量。你可以通过设置 config/app.php 配置文件中的 debug_blacklist 选项来完成这个操作。

环境变量、服务器或者请求数据中都有一些变量是可用的。因此，你可能需要将 $_ENV 和 $_SERVER 的变量加入到黑名单中：

return [  
  // ...  
  'debug_blacklist' => [ 
     '_ENV' => [ 
           'APP_KEY',  
           'DB_PASSWORD', 
        ],   
     '_SERVER' => [  
           'APP_KEY', 
            'DB_PASSWORD',   
          ],  
      '_POST' => [        
          'password',  
          ], 
       ],
   ];

访问配置值

你可以轻松地在应用程序的任何位置使用全局 config 函数来访问配置值。配置值的访问可以使用「点」语法，这其中包含了要访问的文件和选项的名称。还可以指定默认值，如果配置选项不存在，则返回默认值：

$value = config('app.timezone');

要在运行时设置配置值，传递一个数组给 config 函数

config(['app.timezone' => 'America/Chicago']);

配置缓存

为了给你的应用程序提升速度，你应该使用 Artisan 命令 config:cache

php artisan down

Nilai kedua yang dihantar ke fungsi env ialah "nilai lalai". Jika tiada pembolehubah persekitaran wujud untuk kunci yang diberikan, nilai ini akan digunakan. 🎜🎜🎜🎜🎜Menentukan persekitaran semasa🎜🎜Persekitaran semasa aplikasi adalah melalui APP_ENV.env kod fail> pembolehubah ditentukan. Anda boleh mengakses nilai ini melalui kaedah environment dalam fasad App: 🎜

php artisan down --message="Upgrading Database" --retry=60

🎜Anda juga boleh menghantar parameter kepada kaedah environment untuk menyemak semasa Sama ada konfigurasi persekitaran sepadan dengan nilai yang diberikan. Kaedah ini akan mengembalikan true jika ia sepadan dengan nilai yang diberikan: 🎜

php artisan down --allow=127.0.0.1 --allow=192.168.0.0/16

🎜{tip} Persekitaran semasa aplikasi boleh dikesan oleh APP_ENV peringkat pelayan persekitaran Liputan berubah-ubah. Ini berguna apabila mengkonfigurasi persekitaran yang berbeza untuk aplikasi yang sama, supaya anda boleh menetapkan persekitaran tertentu untuk memadankan hos tertentu dalam konfigurasi pelayan anda. 🎜

🎜🎜🎜🎜Sembunyikan pembolehubah persekitaran dalam halaman nyahpepijat🎜🎜Apabila pengecualian tidak ditangkap dan APP_DEBUG pembolehubah persekitaran Apabila benar, halaman nyahpepijat akan memaparkan semua pembolehubah dan kandungan persekitaran. Dalam sesetengah kes anda mungkin ingin menyembunyikan pembolehubah tertentu. Anda boleh melakukan ini dengan menetapkan pilihan debug_blacklist dalam fail konfigurasi config/app.php. 🎜🎜Sesetengah pembolehubah tersedia dalam pembolehubah persekitaran, pelayan atau data permintaan. Oleh itu, anda mungkin perlu menambah pembolehubah $_ENV dan $_SERVER ke senarai hitam: 🎜

php artisan up

🎜🎜🎜

Akses nilai konfigurasi

🎜Anda boleh mengakses nilai konfigurasi dengan mudah dari mana-mana sahaja dalam aplikasi anda menggunakan fungsi global config. Nilai konfigurasi boleh diakses menggunakan sintaks "titik", yang mengandungi nama fail dan pilihan untuk diakses. Anda juga boleh menentukan nilai lalai, yang dikembalikan jika pilihan konfigurasi tidak ada: 🎜rrreee🎜Untuk menetapkan nilai konfigurasi pada masa jalan, hantar tatasusunan ke fungsi config 🎜rrreee🎜🎜🎜

Caching Konfigurasi

🎜Untuk meningkatkan kelajuan aplikasi anda, anda harus cache semua fail konfigurasi ke dalam satu fail menggunakan perintah Artisan config:cache . Ini akan menggabungkan semua pilihan konfigurasi dalam aplikasi anda ke dalam satu fail, yang kemudiannya akan dimuatkan dengan cepat oleh rangka kerja. 🎜

Secara umumnya, anda harus menjalankan perintah php artisan config:cache sebagai sebahagian daripada rutin penggunaan pengeluaran anda. Perintah ini tidak boleh dijalankan dalam persekitaran pembangunan tempatan kerana pilihan konfigurasi selalunya perlu diubah semasa pembangunan aplikasi. php artisan config:cache 命令作为生产环境部署常规工作的一部分。这个命令不应在本地开发环境下运行，因为配置选项在应用程序开发过程中是经常需要被更改的。

{note} 如果在部署过程中执行 config:cache 命令，那你应该确保只从配置文件内部调用 env 函数。一旦配置被缓存，.env 文件将不再被加载，所有对 env 函数的调用都将返回 null。

维护模式

当应用程序处于维护模式时，所有对应用程序的请求都显示为一个自定义视图。这样可以在更新或执行维护时轻松地「关闭」你的应用程序。 维护模式检查包含在应用程序的默认中间件栈中。如果应用程序处于维护模式，则将抛出一个状态码为 503 的 MaintenanceModeException 异常。

要启用维护模式，只需执行下面的 Artisan 的 down 命令：

rrreee

你还可以向 down 命令提供 message 和 retry 选项。其中 message 选项的值可用于显示或记录自定义消息，而 retry 值可用于设置 HTTP 请求头中 Retry-After 的值：

rrreee

即使在维护模式下，也可以使用命令 allow 选项允许特定的 IP 地址或网络访问应用程序：

rrreee

要关闭维护模式，请使用 up 命令：

rrreee

{tip} 你可以通过修改 resources/views/errors/503.blade.php

{note} Jika anda melaksanakan perintah config:cache semasa penempatan, anda harus memastikan bahawa anda hanya memanggil fungsi env dari dalam fail konfigurasi. Setelah konfigurasi dicache, fail .env tidak akan dimuatkan lagi dan semua panggilan ke fungsi env akan mengembalikan null.

Mod Penyelenggaraan

Apabila apl berada dalam mod penyelenggaraan, semua permintaan kepada apl dipaparkan sebagai paparan tersuai. Ini memudahkan untuk "menutup" aplikasi anda semasa mengemas kini atau melakukan penyelenggaraan. Pemeriksaan mod penyelenggaraan disertakan dalam timbunan perisian tengah lalai aplikasi. Jika aplikasi berada dalam mod penyelenggaraan, pengecualian MaintenanceModeException dengan kod status 503 akan dilemparkan.

Untuk mendayakan mod penyelenggaraan, hanya laksanakan perintah down Artisan di bawah:

rrreee

Anda juga boleh memberikan arahan down dengan message dan cuba semula pilihan. Nilai pilihan message boleh digunakan untuk memaparkan atau merekod mesej tersuai dan nilai retry boleh digunakan untuk menetapkan nilai Retry-After< /code> dalam pengepala permintaan HTTP : rrreee Walaupun dalam mod penyelenggaraan, anda boleh menggunakan pilihan arahan benar untuk membenarkan alamat IP atau rangkaian tertentu mengakses aplikasi:

rrreee Untuk mematikan mod penyelenggaraan, gunakan up Perintah: 🎜rrreee

🎜{tip} Anda boleh menyesuaikan templat mod penyelenggaraan lalai dengan mengubah suai resources/views/errors/503.blade.php fail templat. 🎜🎜🎜Mod Penyelenggaraan & Baris Gilir🎜🎜Apabila aplikasi dalam mod penyelenggaraan, tugas giliran tidak akan diproses. Tugasan ini akan terus diproses selepas aplikasi keluar dari mod penyelenggaraan. 🎜🎜Alternatif kepada Mod Penyelenggaraan🎜🎜Mod penyelenggaraan boleh menyebabkan aplikasi anda mengalami masa henti selama beberapa saat (tidak responsif), jadi anda boleh mempertimbangkan untuk menggunakan alternatif seperti Envoyer untuk penggunaan masa sifar dengan Laravel. 🎜🎜Artikel ini pertama kali diterbitkan di laman web 🎜LearnKu.com🎜. 🎜🎜

← Pasang

struktur folder →

serahkan

Laman web PHP Cina

RumahKursusArtikelSoal JawabKamusManualMuat turuncari APPMuat turun

.env 值	env() 值
benar	(bool) benar
(benar)	(sebenarnya) (bool) palsu
(salah)	(bool) false
kosong	(rentetan) ''
(kosong)	(rentetan) ''
null