Download the PHP package saaksin/laravel-administrator without Composer
On this page you can find all versions of the php package saaksin/laravel-administrator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download saaksin/laravel-administrator
More information about saaksin/laravel-administrator
Files in saaksin/laravel-administrator
Package laravel-administrator
Short Description 데이터베이스 기반 라라벨 관리자 페이지
License MIT
Homepage https://administrator.artgrammer.co.kr
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-administrator
Laravel Administrator
기존 FrozenNode의 Laravel-Administrator 패키지가 더 이상 업데이트되지 않아, 이를 바탕으로 Laravel 13 및 최신 프론트엔드 아키텍처 환경에 맞춰 개발하고 있는 관리자 페이지 빌더 패키지입니다.
Administrator를 사용하면 Eloquent 모델과 관계(Relations)를 선언적으로 관리할 수 있으며, 독립적인 사이트 설정 페이지나 대시보드 커스텀 작업을 손쉽게 구축할 수 있습니다.
- Author: 이기석 (GiSeok Lee)
- Website: https://administrator.artgrammer.co.kr
- Release:
13.0.1
🚀 1. 13.0.1 주요 변경
13.0.1은 Laravel 13 전용 지원 범위를 유지하면서 Laravel Octane의 장기 실행 워커에서도 관리자 요청 상태가 서로 섞이지 않도록 요청 생명주기를 격리합니다. PHP-FPM 환경에서도 동일한 기능과 호환성을 유지합니다.
⚡ Laravel Octane 요청 생명주기 지원
- 선택적 실행 환경: Laravel Octane은 호스트 애플리케이션이 선택적으로 설치하는 실행 환경입니다. 패키지의 운영 의존성에는
laravel/octane을 추가하지 않으며 PHP-FPM도 계속 지원합니다. - 워커 요청 상태 격리: 설정, 필드, 컬럼, 액션, 권한, 필터와 페이지당 행 수를 요청별 scoped lifecycle로 관리하여 RoadRunner, Swoole 또는 FrankenPHP 워커의 연속 요청에서 상태가 재사용되지 않게 합니다.
- 로케일 격리: 관리자 로케일은
web세션 미들웨어 이후 매 요청 적용하며, 세션 값이 없거나 허용되지 않으면config('app.locale')로 복원합니다. - Validation 호환성: 관리자 validator가 호스트 애플리케이션의 사용자 정의 validation resolver를 변경하지 않습니다.
- 부트 이벤트 의미 보존:
administrator.ready는 애플리케이션 또는 워커 부트 시 한 번 발생하므로 요청별 상태 초기화에 사용하지 않습니다.
Octane을 사용하는 애플리케이션은 패키지 코드나 설정을 배포한 뒤 실행 중인 워커를 다시 불러와야 합니다.
🎨 13.0.0에서 도입된 설정 기반 디자인 테마
기본 silver 테마와 스타일을 추가하지 않는 legacy 테마를 제공하며, Vite manifest의 테마 엔트리를 기준으로 배포 에셋을 로드합니다.
🎨 프론트엔드 아키텍처 전면 개편 (Vite + Alpine.js v3 + Tailwind CSS)
- 의존성 간소화: 구시대의
Knockout.js및jQuery환경을 완전히 제거하고, 가볍고 빠른 Alpine.js v3와 유연한 Tailwind CSS, 현대적 에셋 번들러인 Vite 체계로 마이그레이션했습니다. - 성능 극대화: 초기 에셋 로딩 크기를 60% 이상 절감하였고, 렌더링 성능과 INP(Interaction to Next Paint) 속도를 2배 이상 향상시켰습니다.
- 프리미엄 & 반응형 UI/UX: 모바일부터 와이드 모니터까지 가로 스크롤 없이 부드럽게 대응하는 완전 반응형 CSS Grid/Flexbox 레이아웃을 제공합니다. 세련된 HSL 기반의 Slate/Indigo 컬러 팔레트와 부드러운 Glassmorphism 효과, 그리고 미려한 다크 모드(Dark Mode)를 기본 제공합니다.
📦 서드파티 라이브러리 경량화 및 에디터 이원화
- Combobox: 무거운
Select2대신 Alpine.js 기반의 경량 커스텀 Combobox 컴포넌트를 사용하여 관계형 데이터 자동완성 검색을 제공합니다. - 업로더: 기존
Plupload대신 HTML5 기본 API를 활용한 바닐라 멀티 업로더를 탑재했습니다. - 에디터: 기존 WYSIWYG 에디터를 최신 Quill(
wysiwyg2) 및 Marked(마크다운 파서) 라이브러리로 대체하고, 기존의 클래식한 CKEditor 4(wysiwyg, Full 스펙) 역시 로컬 번들로 함께 제공하여 목적에 맞게 두 에디터 중 선택해서 적용할 수 있는 유연한 환경을 제공합니다. - 문서 및 보안 정비: VitePress 기반 공식 문서 사이트를 제공하고, 마크다운 링크/이미지 렌더링에서 위험 프로토콜을 차단하여 XSS 방어를 강화했습니다.
📋 2. 시스템 요구사항
- Laravel
^13.0 - PHP
^8.3 - 선택 사항: Laravel Octane
^2.0을 사용하는 RoadRunner, Swoole 또는 FrankenPHP 호스트 환경 - 개발 및 검증: Orchestra Testbench
^11.0, PHPUnit^11.0
13.0.1은 Laravel ^13.0과 PHP ^8.3만 지원합니다. Octane을 설치하지 않은 PHP-FPM 환경도 정상 지원합니다.
🛠️ 3. 설치 방법 (Composer)
Composer를 사용하여 Laravel 13 애플리케이션에 설치할 수 있습니다.
설치 후, config/app.php 의 providers 배열에 서비스 프로바이더를 등록합니다.
이 후, 서비스 프로바이더 기준 publish 명령을 실행합니다.
config/administrator.php 설정파일이 추가 되고, public 디렉토리에 관련 에셋(CKEditor 4 에셋 포함), 뷰, 언어 파일 등이 복사됩니다.
[!IMPORTANT]
설정 파일들은 config 디렉토리 하위가 아닌, 프로젝트 루트 디렉토리의administrator/,administrator/settings/에 위치합니다.
⚙️ 4. 설정 파일 구성 (Configuration)
📄 설정파일 정의
라라벨의 설정 캐싱(php artisan config:cache) 기능을 오류 없이 100% 안전하게 사용하고 글로벌 함수 선언 충돌을 완벽히 차단하기 위해, 순수 PHP 배열 반환 구조(return [ ... ];)를 사용해 주십시오. (레거시 하위 호환을 위해 파일명과 일치하는 글로벌 함수 래핑 방식 function users() { ... }도 지원하지만 권장하지 않습니다.)
🎨 디자인 테마 및 사용자 정의 CSS/JS 파일 지정
config/administrator.php 에 테마 및 커스텀 에셋 항목을 추가하여 레이아웃을 확장할 수 있습니다.
✨ 5. 제공되는 확장 및 부가 기능
🔐 HTTPS 환경 연동
app/Providers/AppServiceProvider.php 에서 라우트의 경로가 https 가 되도록 지정합니다.
asset url 에 https 주소를 사용하도록 .env 에 ASSET_URL 을 지정합니다.
🔍 MySQL FULL TEXT 검색 지원
filter 에서 MySQL 의 full text 검색을 지원합니다. (대용량 테이블 검색에 유리합니다.)
⚡ TEXT 빠른 검색 (Quick Search Filter)
filter 에서 시작 단어 검색 및 포커스 아웃 이벤트 시 즉시 검색을 시작하는 유용한 필터 타입입니다.
🔄 페이지 리로드 (Reload Page)
액션을 성공적으로 실행한 후, 현재 페이지를 리로드하는 기능을 제공합니다.
💾 VIEW 모델 지원 (실험 중)
모델 설정에서 view 모델 여부를 설정할 수 있습니다. (아직은 실험적인 기능이며, 조회 시 데이터베이스 로드를 최적화하여 약간의 성능 개선을 기대할 수 있습니다. MySQL InnoDB 환경 권장)
🚫 6. 지원 버전 안내
13.0.1은 Laravel ^13.0과 PHP ^8.3만 지원하며, 이 범위를 벗어난 런타임은 지원하지 않습니다. PHP-FPM과 호스트가 선택적으로 설치한 Laravel Octane 2.x 실행 환경을 지원합니다.
🛠️ 7. 에셋 개발 및 빌드 (Developer Guide)
패키지의 프론트엔드 소스코드(resources/js, resources/css 등)를 직접 수정하여 기여하거나 커스터마이징하고 싶다면 패키지 루트 디렉토리에서 다음 NPM 명령어를 활용해 주세요.
📖 8. Documentation
Administrator 공식 문서는 https://administrator.artgrammer.co.kr에서 확인할 수 있습니다. 이 패키지의 루트 디렉토리에 있는 docs/ 디렉토리에서도 한국어 설명 문서를 포함한 상세 가이드를 찾아볼 수 있습니다.
📄 9. Copyright and License
Administrator was written by Jan Hartigan of Frozen Node for the Laravel framework.
It is currently developed, modernized, and maintained by GiSeok Lee (SaAkSin).
Administrator is released under the MIT License. See the LICENSE file for details.
📝 10. Changelog
변경 이력은 RELEASE_NOTES.md에서 확인할 수 있습니다.
