laravel.io
1.0.0
Это репозиторий портала сообщества 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 , чтобы связать сайт с тестируемым веб-адресом.
Создайте testing базу данных в MySQL, чтобы вы могли запустить набор тестов.
Настройте (дополнительные) функции ниже
Теперь вы можете посетить приложение в своем браузере, посетив http://laravel.io.test. Если вы заполнили базу данных, вы можете войти в тестовую учетную запись с помощью testing и password .
Чтобы аутентификация GitHub работала локально, вам необходимо зарегистрировать новое приложение OAuth на GitHub. Используйте http://laravel.io.test для URL-адреса домашней страницы и http://laravel.io.test/auth/github для URL-адреса обратного вызова. Создав приложение, введите идентификатор и секретный код в файле .env в переменных env ниже. Теперь вы сможете пройти аутентификацию с помощью GitHub.
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
Чтобы поиск Algolia работал локально, вам необходимо зарегистрировать новую учетную запись и создать индекс под названием threads . У Algolia есть бесплатный уровень, который удовлетворяет всем требованиям, необходимым для среды разработки. Теперь обновите указанные ниже переменные в вашем файле .env . Идентификатор приложения и секретные ключи можно найти в разделе API Keys пользовательского интерфейса Algoila.
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: импортировать приложениемоделипотоки
Новые темы будут автоматически добавляться в индекс, а обновляемые темы будут автоматически синхронизироваться. Если вам нужно очистить индекс и начать заново, вы можете запустить следующую команду:
php artisan scout:flush AppModelsThread
Чтобы опубликованные статьи можно было автоматически публиковать на X, вам необходимо создать приложение. После создания приложения обновите указанные ниже переменные в вашем файле .env . Потребительский ключ и секрет, а также токен и секрет доступа можно найти в разделе Keys and tokens пользовательского интерфейса X-разработчиков.
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
Чтобы сделать то же самое для Bluesky, вам просто нужно настроить ключи приложения с вашим логином и паролем:
BLUESKY_USERNAME= BLUESKY_PASSWORD=
Утвержденные статьи публикуются в том порядке, в котором они были отправлены на утверждение. Статьи публикуются дважды в день в 14:00 и 18:00 UTC. После того, как статья была опубликована, она больше не будет опубликована.
Laravel.io может уведомлять разработчиков о новых отправленных статьях через Telegram. Чтобы это работало, вам необходимо настроить бота Telegram и получить токен. Затем настройте канал, на который вы хотите отправлять сообщения о новых статьях.
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
Чтобы включить подсчет просмотров статей, вам необходимо зарегистрировать учетную запись Fathom Analytics и установить ее на сайте. Затем вам нужно будет создать токен API и найти идентификатор своего сайта, прежде чем обновлять указанные ниже переменные среды в вашем файле .env .
FATHOM_SITE_ID= FATHOM_TOKEN=
Чтобы убедиться, что изображения статей и пользовательских заголовков синхронизируются с базой данных, нам необходимо настроить ключ доступа из Unsplash. Обратите внимание, что вашему приложению Unsplash требуется производственный доступ.
UNSPLASH_ACCESS_KEY=
После этого вы можете добавить идентификатор фотографии Unsplash в любую строку статьи в столбце hero_image_id и запустить команду синхронизации, чтобы получить URL-адрес изображения и данные автора:
PHP Artisan lio:sync-article-images
| Команда | Описание |
|---|---|
vendor/bin/pest -p | Запуск тестов с параллельным выполнением |
php artisan migrate:fresh --seed | Сбросить базу данных |
npm run dev | Создавайте и отслеживайте изменения в файлах CSS и JS. |
Портал Laravel.io в настоящее время поддерживается Дрисом Винтсом и Джо Диксоном. Если у вас есть какие-либо вопросы, не стесняйтесь создавать проблемы в этом репозитории.
Пожалуйста, прочитайте руководство по участию, прежде чем создавать проблему или отправлять запрос на включение.
Пожалуйста, прочтите наш Кодекс поведения, прежде чем вносить свой вклад или участвовать в обсуждениях.
Пожалуйста, ознакомьтесь с нашей политикой безопасности, чтобы узнать, как сообщать об уязвимостях безопасности.
Лицензия MIT. Дополнительную информацию см. в файле лицензии.
