原文 http://laravelacademy.org/post/5762.html
1、根目錄
App目錄
app 目錄包含了應(yīng)用的核心代碼既绕,此外你為應(yīng)用編寫的代碼絕大多數(shù)也會(huì)放到這里啄刹;
Bootstrap目錄
bootstrap 目錄包含了少許文件,用于框架的啟動(dòng)和自動(dòng)載入配置凄贩,還有一個(gè)cache 文件夾用于包含框架為提升性能所生成的文件誓军,如路由和服務(wù)緩存文件;
Config目錄
config 目錄包含了應(yīng)用所有的配置文件怎炊,建議通讀一遍這些配置文件以便熟悉所有配置項(xiàng)谭企;
Database目錄
database 目錄包含了數(shù)據(jù)遷移及填充文件,如果你喜歡的話還可以將其作為 SQLite 數(shù)據(jù)庫(kù)存放目錄评肆;
Public目錄
public 目錄包含了入口文件 index.php 和前端資源文件(圖片债查、JavaScript、CSS等)瓜挽;
Resources目錄
resources 目錄包含了視圖文件及原生資源文件(LESS盹廷、SASS、CoffeeScript)久橙,以及本地化文件俄占;
Routes目錄
routes 目錄包含了應(yīng)用的所有路由定義。Laravel默認(rèn)提供了三個(gè)路由文件: web.php 淆衷、 api.php 和 console.php 缸榄。
web.php 文件包含的路由都會(huì)應(yīng)用web中間件組,具備Session祝拯、CSRF防護(hù)以及Cookie加密功能甚带,如果應(yīng)用無需提供無狀態(tài)的、RESTful風(fēng)格的API佳头,所有路由都會(huì)定義在 web.php 文件鹰贵。
api.php 文件包含的路由應(yīng)用了 api 中間件組,具備頻率限制功能康嘉,這些路由是無狀態(tài)的碉输,所以請(qǐng)求通過這些路由進(jìn)入應(yīng)用需要通過token進(jìn)行認(rèn)證并且不能訪問Session狀態(tài)。
console.php 文件用于定義所有基于閉包的控制臺(tái)命令亭珍,每個(gè)閉包都被綁定到一個(gè)控制臺(tái)命令并且允許與命令行IO方法進(jìn)行交互敷钾,盡管這個(gè)文件并不定義HTTP路由枝哄,但是它定義了基于控制臺(tái)的應(yīng)用入口(路由)。
Storage目錄
storage 目錄包含了編譯過的Blade模板闰非、基于文件的session膘格、文件緩存,以及其它由框架生成的文件财松,該目錄被細(xì)分為成 app 瘪贱、 framework 和 logs 子母錄, app目錄用于存放應(yīng)用要使用的文件辆毡, framework 目錄用于存放框架生成的文件和緩存菜秦,最后, logs 目錄包含應(yīng)用的日志文件舶掖;
storage/app/public 目錄用于存儲(chǔ)用戶生成的文件球昨,比如可以被公開訪問的用戶頭像,要達(dá)到被訪問的目的眨攘,你還需要在 public 目錄下生成一個(gè)軟連接 storage 指向這個(gè)目錄主慰。可以通過 php artisan storage:link 命令生成這個(gè)軟鏈接鲫售。
Tests目錄
tests 目錄包含自動(dòng)化測(cè)試共螺,其中已經(jīng)提供了一個(gè)開箱即用的 PHPUnit 示例;每一個(gè)測(cè)試類都要以 Test 開頭情竹,可以通過 phpunit 或 php vendor/bin/phpunit 命令來運(yùn)行測(cè)試藐不。
Vendor目錄
vendor 目錄包含 Composer 依賴。
2秦效、App目錄
應(yīng)用的核心代碼位于 app 目錄下雏蛮,默認(rèn)情況下,該目錄位于命名空間 App 下阱州, 并且被 Composer 通過 PSR-4自動(dòng)載入標(biāo)準(zhǔn) 自動(dòng)加載挑秉。
app 目錄下包含多個(gè)子目錄,如 Console 苔货、 Http 衷模、 Providers 等。 Console 和 Http 目錄提供了進(jìn)入應(yīng)用核心的API蒲赂,HTTP協(xié)議和CLI是和應(yīng)用進(jìn)行交互的兩種機(jī)制,但實(shí)際上并不包含應(yīng)用邏輯刁憋。換句話說滥嘴,它們只是兩個(gè)向應(yīng)用發(fā)布命令的方式。Console 目錄包含了所有的Artisan命令至耻, Http 目錄包含了控制器若皱、中間件和請(qǐng)求等镊叁。
其他目錄將會(huì)在通過Artisan命令make生成相應(yīng)類的時(shí)候生成到 app 目錄下。例如走触, app/Jobs 目錄直到你執(zhí)行 make:job 命令生成任務(wù)類時(shí)才會(huì)出現(xiàn)在 app 目錄下晦譬。
注意: app 目錄中的很多類都可以通過Artisan命令生成,要查看所有有效的命令互广,可以在終端中運(yùn)行 php artisan list make 命令敛腌。
Console目錄
Console 目錄包含應(yīng)用所有自定義的Artisan命令,這些命令類可以使用 make:command
命令生成惫皱。該目錄下還有console核心類像樊,在這里可以注冊(cè)自定義的Artisan命令以及定義調(diào)度任務(wù)。
Events目錄
這個(gè)目錄默認(rèn)不存在旅敷,但是可以通過 event:generate 和 event:make 命令創(chuàng)建生棍。該目錄用于存放事件類。事件類用于告知應(yīng)用其他部分某個(gè)事件發(fā)生并提供靈活的媳谁、解耦的處理機(jī)制涂滴。
Exceptions目錄
Exceptions 目錄包含應(yīng)用的異常處理器,同時(shí)還是處理應(yīng)用拋出的任何異常的好地方晴音。如果你想要自定義異常如何記錄異橙嶙荩或渲染,需要修改 Handler 類段多。
Http目錄
Http 目錄包含了控制器首量、中間件以及表單請(qǐng)求等,幾乎所有進(jìn)入應(yīng)用的請(qǐng)求處理都在這里進(jìn)行进苍。
Jobs目錄
該目錄默認(rèn)不存在加缘,可以通過執(zhí)行 make:job 命令生成, Jobs 目錄用于存放隊(duì)列任務(wù)觉啊,應(yīng)用中的任務(wù)可以被隊(duì)列化拣宏,也可以在當(dāng)前請(qǐng)求生命周期內(nèi)同步執(zhí)行。同步執(zhí)行的任務(wù)有時(shí)也被看作命令杠人,因?yàn)樗鼈儗?shí)現(xiàn)了命令模式勋乾。
Listeners目錄
這個(gè)目錄默認(rèn)不存在,可以通過執(zhí)行 event:generate 和 make:listener 命令創(chuàng)建嗡善。 Listeners 目錄包含處理事件的類(事件監(jiān)聽器)辑莫,事件監(jiān)聽器接收一個(gè)事件并提供對(duì)該事件發(fā)生后的響應(yīng)邏輯,例如罩引, UserRegistered 事件可以被 SendWelcomeEmail 監(jiān)聽器處理各吨。
Mail目錄
這個(gè)目錄默認(rèn)不存在,但是可以通過執(zhí)行 make:mail 命令生成袁铐, Mail 目錄包含郵件發(fā)送類揭蜒,郵件對(duì)象允許你在一個(gè)地方封裝構(gòu)建郵件所需的所有業(yè)務(wù)邏輯横浑,然后使用Mail::send 方法發(fā)送郵件。
Notifications目錄
這個(gè)目錄默認(rèn)不存在屉更,你可以通過執(zhí)行 make:notification 命令創(chuàng)建徙融, Notifications 目錄包含應(yīng)用發(fā)送的所有通知,比如事件發(fā)生通知瑰谜。Laravel的通知功能將通知發(fā)送和通知驅(qū)動(dòng)解耦欺冀,你可以通過郵件,也可以通過Slack似舵、短信或者數(shù)據(jù)庫(kù)發(fā)送通知脚猾。
Policies目錄
這個(gè)目錄默認(rèn)不存在,可以通過執(zhí)行 make:policy 命令來創(chuàng)建砚哗, Policies 目錄包含了所有的授權(quán)策略類龙助,策略用于判斷某個(gè)用戶是否有權(quán)限去訪問指定資源。更多詳情蛛芥,請(qǐng)查看授權(quán)文檔提鸟。
Providers目錄
Providers 目錄包含應(yīng)用的所有服務(wù)提供者。服務(wù)提供者在啟動(dòng)應(yīng)用過程中綁定服務(wù)到容器仅淑、注冊(cè)事件以及執(zhí)行其他任務(wù)以為即將到來的請(qǐng)求處理做準(zhǔn)備称勋。