這是 Laravel.io 社群入口網站的儲存庫。該程式碼完全開源,並根據 MIT 許可證獲得許可。我們歡迎您的貢獻,但我們鼓勵您在創建問題或發送拉取請求之前閱讀貢獻指南。請閱讀下面的安裝指南,開始在您的電腦上設定應用程式。
我們要感謝這些優秀的公司對我們的贊助。如果您有興趣成為贊助商,請造訪 Laravel.io GitHub 贊助商頁面。
事件
鍛造
使者
捉摸
廷克韋爾
拜雷斯·德夫
N-iX
開始安裝需要以下工具。
PHP 8.3
作曲家
國家公共管理
代客泊車
請注意,您可以隨意將
~/Sites/laravel.io
位置調整為電腦上您想要的任何目錄。執行此操作時,請務必在所需目錄中執行valet link
命令。
使用git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io
複製此儲存庫
執行composer install
來安裝PHP依賴項
設定一個名為laravel
的本地資料庫
運行composer setup
來設定應用程式
設定一個有效的電子郵件驅動程序,例如 Mailtrap
執行valet link
將網站連結到測試網址
在 MySQL 中建立一個testing
資料庫,以便您可以執行測試套件
從下面配置(可選)功能
現在,您可以透過造訪 http://laravel.io.test 在瀏覽器中存取該應用程式。如果您播種了資料庫,您可以使用testing
和password
登入測試帳戶。
要使 GitHub 身份驗證在本地工作,您需要在 GitHub 上註冊新的 OAuth 應用程式。使用http://laravel.io.test
作為首頁 url,使用http://laravel.io.test/auth/github
作為回呼 url。建立應用程式後,請在下面的環境變數中填寫.env
檔案中的 ID 和金鑰。現在您應該能夠使用 GitHub 進行身份驗證。
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
要在本地運行 Algolia 搜索,您需要註冊一個新帳戶並建立一個名為threads
索引。 Algolia 有一個免費套餐,可滿足開發環境所需的所有要求。現在更新.env
檔案中的以下變數。應用程式 ID 和金鑰可以在 Algoila UI 的API Keys
部分找到。
SCOUT_DRIVER=algolia SCOUT_QUEUE=true ALGOLIA_APP_ID= ALGOLIA_SECRET="Use the Write API Key" VITE_ALGOLIA_APP_ID="${ALGOLIA_APP_ID}" VITE_ALGOLIA_SECRET="Use the Search API Key" VITE_ALGOLIA_THREADS_INDEX=threads VITE_ALGOLIA_ARTICLES_INDEX=articles VITE_ALGOLIA_USERS_INDEX=users
為了對現有線程建立索引,請執行以下命令:
php artisan scout:導入 AppModelsThread
新線程將自動添加到索引中,並且更新的線程將自動同步。如果您需要刷新索引並重新開始,可以執行以下命令:
php artisan scout:flush 應用程式模型線程
要讓已發布的文章能夠在 X 上自動分享,您需要建立一個應用程式。建立應用程式後,更新.env
檔案中的以下變數。消費者金鑰和秘密以及存取權杖和秘密可以在 X 開發人員 UI 的Keys and tokens
部分中找到。
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
要對 Bluesky 執行相同的操作,您只需使用您的登入名稱和密碼設定應用程式金鑰:
BLUESKY_USERNAME= BLUESKY_PASSWORD=
經批准的文章按照提交批准的順序共享。文章每天分享兩次,時間為 UTC 時間 14:00 和 18:00。文章一旦被分享,就不會再分享。
Laravel.io 可以透過 Telegram 通知維護者新提交的文章。為此,您需要設定 Telegram 機器人並獲取令牌。然後,設定您要將新文章訊息傳送到的頻道。
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
要啟用文章的查看計數,您需要註冊 Fathom Analytics 帳戶並將其安裝在網站上。然後,您需要建立一個 API 令牌並尋找您的網站 ID,然後再更新.env
檔案中的以下環境變數。
FATHOM_SITE_ID= FATHOM_TOKEN=
為了確保文章和使用者標題圖像同步到資料庫中,我們需要從 Unsplash 設定存取金鑰。請注意,您的 Unsplash 應用程式需要生產存取權。
UNSPLASH_ACCESS_KEY=
之後,您可以將 Unsplash 照片 ID 新增至hero_image_id
列中的任何文章行,並執行同步命令以取得影像 url 和作者資料:
php artisan lio:同步文章圖片
命令 | 描述 |
---|---|
vendor/bin/pest -p | 透過並行執行來運行測試 |
php artisan migrate:fresh --seed | 重置資料庫 |
npm run dev | 建立並觀察 CSS 和 JS 檔案的更改 |
Laravel.io 入口網站目前由 Dries Vints 和 Joe Dixon 維護。如果您有任何疑問,請隨時在此儲存庫上建立問題。
請在建立問題或發送拉取請求之前閱讀貢獻指南。
請在貢獻或參與討論之前閱讀我們的行為準則。
請查看我們的安全政策,以了解如何通報安全漏洞。
麻省理工學院許可證。請參閱許可證文件以獲取更多資訊。