JinyPHP 패키지 설치 및 설정 가이드

JinyPHP는 Laravel을 기반으로 구축된 확장 프레임워크로, ERP, CMS, 관리자 패널 등의 기능을 제공합니다.

1️⃣ JinyPHP 핵심 패키지 설치

1.1 JinyERP 핵심 패키지 설치

# JinyERP 코어 패키지들
composer require jiny/auth
composer require jiny/admin
composer require jiny/site

# 또는 로컬 패키지로 개발하는 경우
# composer.json에 추가

1.2 로컬 패키지 개발 설정

composer.json에 로컬 패키지 설정:

{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/jiny/*"
        }
    ],
    "require": {
        "jiny/auth": "dev-main",
        "jiny/admin": "dev-main",
        "jiny/site": "dev-main"
    }
}

📁 JinyERP 패키지 관련 파일 경로:

2️⃣ 추가 유용한 패키지

2.1 개발 및 확장 패키지

# 개발 도구
composer require --dev barryvdh/laravel-debugbar
composer require --dev barryvdh/laravel-ide-helper

# API 개발
composer require laravel/sanctum

# 파일 관리
composer require spatie/laravel-medialibrary

# 권한 관리
composer require spatie/laravel-permission

# 다국어 지원
composer require mcamara/laravel-localization

# 이미지 처리
composer require intervention/image

# Excel 처리
composer require maatwebsite/excel

2.2 패키지 설정 발행

# 인증 관련
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"

# Debugbar 설정
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

# 권한 관리
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"

# 미디어 라이브러리
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"

# JinyPHP 관련 설정 발행 (예상)
php artisan vendor:publish --provider="Jiny\Auth\AuthServiceProvider"
php artisan vendor:publish --provider="Jiny\Admin\AdminServiceProvider"
php artisan vendor:publish --provider="Jiny\Site\SiteServiceProvider"

📁 발행된 설정 파일 경로:

3️⃣ JinyPHP 패키지 설정 및 초기화

3.1 패키지 마이그레이션 실행

# JinyPHP 관련 마이그레이션 실행
php artisan migrate

# 특정 패키지 마이그레이션만 실행하는 경우
php artisan migrate --path=/vendor/jiny/auth/database/migrations
php artisan migrate --path=/vendor/jiny/admin/database/migrations
php artisan migrate --path=/vendor/jiny/site/database/migrations

3.2 JinyPHP 시더 및 초기 데이터

# JinyPHP 관련 시더 실행 (있는 경우)
php artisan db:seed --class=JinyAuthSeeder
php artisan db:seed --class=JinyAdminSeeder
php artisan db:seed --class=JinySiteSeeder

# 전체 시더 실행
php artisan db:seed

3.3 JinyPHP 에셋 발행

# JinyPHP 정적 파일 발행
php artisan vendor:publish --tag=jiny-auth-assets
php artisan vendor:publish --tag=jiny-admin-assets
php artisan vendor:publish --tag=jiny-site-assets

# 또는 전체 에셋 발행
php artisan vendor:publish --tag=public

📁 발행된 에셋 파일 경로:

4️⃣ JinyPHP 환경 설정

4.1 .env 파일 JinyPHP 관련 설정

# JinyPHP 기본 설정
JINY_AUTH_ENABLED=true
JINY_ADMIN_ENABLED=true
JINY_SITE_ENABLED=true

# JinyPHP Admin 설정
JINY_ADMIN_PREFIX=admin
JINY_ADMIN_MIDDLEWARE=web,auth
JINY_ADMIN_THEME=default

# JinyPHP Site 설정
JINY_SITE_PREFIX=site
JINY_SITE_THEME=default
JINY_SITE_CACHE_ENABLED=true

# JinyPHP Auth 설정
JINY_AUTH_GUARD=web
JINY_AUTH_PASSWORD_RESET=true
JINY_AUTH_EMAIL_VERIFICATION=false

4.2 config/app.php 서비스 프로바이더 등록

'providers' => [
    // Laravel 기본 프로바이더들...

    // JinyPHP 서비스 프로바이더들
    Jiny\Auth\AuthServiceProvider::class,
    Jiny\Admin\AdminServiceProvider::class,
    Jiny\Site\SiteServiceProvider::class,
],

📁 JinyPHP 설정 관련 파일 경로:

5️⃣ JinyPHP 개발 및 사용법

5.1 JinyPHP Admin 접속

# Admin 패널 접속 (기본 설정)
# http://localhost:8000/admin

# Admin 사용자 생성 (artisan 명령어가 있는 경우)
php artisan jiny:admin:create-user

5.2 JinyPHP 컴포넌트 생성

# JinyPHP 컴포넌트 생성 (예상 명령어)
php artisan make:jiny-component ComponentName
php artisan make:jiny-admin AdminComponentName
php artisan make:jiny-site SiteComponentName

# JinyPHP 모델 생성
php artisan make:jiny-model ModelName

5.3 JinyPHP 캐시 관리

# JinyPHP 관련 캐시 클리어
php artisan jiny:cache:clear

# JinyPHP 설정 캐시 재생성
php artisan jiny:config:cache

# 전체 최적화 (JinyPHP 포함)
php artisan optimize
php artisan jiny:optimize

📁 JinyPHP 개발 관련 파일 경로:

✅ JinyPHP 설치 완료 체크리스트

1️⃣ 패키지 설치

2️⃣ 초기화 및 설정

3️⃣ 기능 확인

🔗 관련 문서

📚 추가 정보

JinyPHP 공식 리소스

개발 참고사항