Download the PHP package opgginc/laravel-essentials-entry without Composer
On this page you can find all versions of the php package opgginc/laravel-essentials-entry. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download opgginc/laravel-essentials-entry
More information about opgginc/laravel-essentials-entry
Files in opgginc/laravel-essentials-entry
Package laravel-essentials-entry
Short Description Essential Laravel modules collection for Entry team
License AGPL-3.0-only
Informations about the package laravel-essentials-entry
Essential Packages for Entry Cell in OP.GG
Requirements
- PHP ^8.3
- Laravel 10.x, 11.x, 12.x
Installation
설정 파일을 게시하려면:
기능
1. 메타 태그 관리
이 패키지는 butschster/meta-tags 패키지를 기반으로 하여 SEO를 위한 메타 태그를 자동으로 관리합니다. 설정된 내용에 따라 사이트 전체에 필요한 메타 태그가 자동으로 적용됩니다.
설정
config/essentials-entry.php
파일에서 메타 태그 설정을 변경할 수 있습니다:
다국어 지원
메타 태그 텍스트는 다국어 파일에서 가져옵니다. 각 언어 폴더에 seo.php
파일을 생성하고 다음과 같이 구성하세요:
사용 방법
블레이드 템플릿의 <head>
섹션에 다음 코드를 추가하세요:
기존 <title>Laravel</title>
태그 대신 위 코드를 사용하면 다음과 같은 메타 태그가 자동으로 생성됩니다:
Inertia.js와 함께 사용하기
Inertia.js를 사용하는 경우 다음과 같이 설정하여 함께 사용할 수 있습니다:
2. 사이트맵 생성
이 패키지를 설치하면 자동으로 사이트맵을 생성하고 스케줄링됩니다. 단, 어떻게 사이트맵을 생성할 것인지 설정 파일에서 잘 설정해주어야합니다.
주의: 이 기능은 Cache 에 저장한 후에 웹에서 서빙할 수 있도록 해줍니다. 사이트맵 파일이 너무 커지는 경우, 캐시에 담을 수 없을 경우도 생길 수 있습니다. 그러면 이 기능을 비활성화하고 직접 sitemap.xml 을 처음부터 구현하시기 바랍니다.
설정
config/essentials-entry.php
파일에서 사이트맵 설정을 변경할 수 있습니다:
2. 사이트 언어 관리 (다국어 URL 설정)
opgginc/codezero-laravel-localized-routes 패키지를 사용하여 URL 경로에 언어 코드를 포함하고 자동으로 언어를 감지합니다. 이 패키지는 codezero/laravel-localized-routes
의 포크 버전으로, 원본 패키지의 관리자 사망으로 인해 유지보수가 중단된 후 자체적으로 관리하고 있는 버전입니다.
미들웨어 등록
bootstrap/app.php
파일에 미들웨어를 등록하세요:
언어 감지 미들웨어는 SubstituteBindings
미들웨어 뒤에 배치해야 합니다.
라우트 설정
모든 다국어 라우트는 Route::localized()
내부에 정의해야 합니다:
설정
config/essentials-entry.php
파일에서 지원할 언어와 기본 언어를 설정할 수 있습니다:
언어 감지 메커니즘
본 패키지는 다음과 같은 순서와 우선순위로 사용자의 언어를 감지합니다:
-
URL 경로 분석: URL 경로에 언어 코드가 포함된 경우 이를 우선 사용
- 예:
/ko_KR/about
경로에서ko_KR
감지
- 예:
-
쿠키 기반 감지: 이전에 저장된 언어 설정이 있는 경우 해당 언어로 리다이렉트
- 쿠키에 저장된 언어가 URL 경로와 다를 경우 쿠키 값 기준으로 리다이렉트
-
브라우저 언어 감지: 사용자 브라우저의
Accept-Language
헤더 분석- 경로에 언어가 없거나 기본 언어일 때 브라우저 언어가 다르면 해당 언어로 리다이렉트
- 기본 언어 적용: 위 모든 방법으로 언어를 감지하지 못한 경우 기본 언어 사용
언어 매칭 알고리즘
LocaleMatcher
클래스는 브라우저나 쿠키에서 감지한 언어를 지원 언어와 매칭할 때 다음 순서로 처리합니다:
-
정확한 일치: 완전히 동일한 언어 코드 확인 (예:
ko_KR
→ko_KR
) -
특별 매핑 확인:
locale_mappings
설정에 정의된 대체 가능 언어 확인- 예:
zh_HK
가 감지되었고 설정에'zh_HK' => 'zh_TW'
가 있으면zh_TW
사용
- 예:
-
기본 언어 코드 매칭: 언어 코드의 기본 부분만 일치하는지 확인
- 예: 브라우저에서
zh
가 감지되면supported
배열에서 처음 나오는zh_
로케일 선택 - 이때 배열 순서가 중요:
zh_CN
이zh_TW
보다 먼저 정의되면zh
→zh_CN
매핑
- 예: 브라우저에서
- 기본 언어 반환: 모든 매칭이 실패하면 기본 언어(
default
) 사용
실제 동작 예시
라우트 생성 예시
3. 로봇 차단 파일(robots.txt) 생성
사이트맵과 함께 robots.txt 파일도 자동으로 생성할 수 있습니다.
테스트
TODO LIST
다음 기능들은 향후 구현 예정입니다:
- ✅ 메타 태그 관리: SEO 및 소셜 미디어를 위한 메타 태그 자동 관리 (완료)
- JSON-LD 스키마 지원: 구조화된 데이터를 위한 JSON-LD 스키마 추가
- 변경한 언어코드를 위한 리다이렉트 기능
Included Packages
- opgginc/codezero-laravel-localized-routes - Create localized routes in Laravel
- kargnas/laravel-ai-translator - AI-powered translation
- spatie/laravel-sitemap - Generate sitemaps
License
AGPL-3.0-only
All versions of laravel-essentials-entry with dependencies
illuminate/config Version >=11
illuminate/support Version >=11
illuminate/contracts Version >=11
illuminate/console Version >=11
illuminate/http Version >=11
butschster/meta-tags Version ^3.0
kargnas/laravel-ai-translator Version >=1.7
spatie/laravel-sitemap Version ^7.0
opgginc/codezero-laravel-localized-routes Version ^5.1
annexare/countries-list Version ^3.1
nesbot/carbon Version ^3.9