jiny/jinyshop

The skeleton application for JinyShop

0.1.0 2024-05-06 16:26 UTC

Requires

• php: ^8.2
• dcblogdev/laravel-module-generator: ^2.0.3
• jiny/admin: ^0.3.0
• jiny/auth: ^0.3.3
• jiny/config: ^0.1.0
• jiny/fortify: ^0.0.2
• jiny/html: ^0.3.0
• jiny/icons: ^0.3.1
• jiny/laravel: ^0.0.2
• jiny/locale: ^0.3.2
• jiny/manual: ^0.0.2
• jiny/modules: ^0.3.2
• jiny/permit: ^0.3.0
• jiny/posts: ^0.0.3
• jiny/profile: ^0.3.1
• jiny/site: ^0.0.7
• jiny/social: ^0.3.0
• jiny/theme: ^0.3.1
• jiny/ui: ^0.3.2
• jiny/ui2: ^0.3.0
• jiny/users: ^0.3.0
• jiny/widgets: ^0.0.2
• jiny/wiretable: ^0.3.2
• laravel/framework: ^11.5
• laravel/sanctum: ^4.0.2
• laravel/tinker: ^2.9
• livewire/livewire: ^3.4
• nwidart/laravel-modules: ^11.0.8

Requires (Dev)

• fakerphp/faker: ^1.23.1
• larastan/larastan: ^2.9.5
• laravel/pint: ^1.15.2
• laravel/sail: ^1.29.1
• mockery/mockery: ^1.6.11
• nunomaduro/collision: ^8.1.1
• pestphp/pest: ^2.34.7
• pestphp/pest-plugin-laravel: ^2.4
• spatie/laravel-ignition: ^2.6

MIT

• framework
• laravel

README

지니PHP은 Laravel을 기반으로 완전한 웹사이트를 구현할 수 있는 기본골격을 제공합니다.

설치

지니PHP는 라라벨을 기반으로 운영됩니다. 라라벨은 PHP언어와 컴포저, 그리고 Mysql과 같은 RDBMS가 필요로 합니다.

• php설치 및 다운로드
• 컴포저 설치
• mysql 설치

프로젝트 설치

라라벨로 구성된 지니PHP 프로젝트를 설치합니다. jiny/jiny 프로젝트는 라라벨을 확장한 페키지 입니다.

composer create-project jiny/jiny 프로젝트

컴포저는 필요한 의존 파일을 프로젝트 생성과 동시에 자동으로 설치해 주기 때문에 매우 편리한 도구 입니다.

환경설정 및 DB 마이그레이션

데이터베이스 연동을 위하여 .env를 수정합니다. 지니PHP는 기본적으로 Mysql과 같은 RDBMS를 사용합니다.

라라벨 11버젼 부터는 기본 DB가 SQLight로 설정되어 있습니다. SQLight를 사용하기 위해서는 php.ini에서 pdo_sqlight 드라이버를 확장해 주어야 합니다.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

데이터베이스 연결을 위해서 먼저, mysql 접속 터미널 에서 사용자와 스키마를 생성해 주어야 합니다. 또한, 테이블 생성 및 변경을 위한 권환도 같이 부여해 주셔야 합니다.

초기 테이블을 생성합니다. 이를 위해서 라라벨의 migrate명령을 실행합니다.

php artisan migrate

CSS 및 Asset 설치

front 화면을 처리하기 위한 css 및 assets 을 빌드합니다. 이를 위해서는 nodejs가 필요로 합니다.

npm install
npm run build

서버 실행

데이터베이스와 화면 assets 이 빌드가 완료가 되었으면, PHP 내장 웹서버를 통하여 프로젝트를 실행합니다.

php artisan serve

사이트 구축 및 디자인

지니PHP는 라라벨을 기반으로 손쉽게 웹사이트를 구축할 수 있는 기능들을 제공합니다. 지니PHP는 유연한 웹사이트 구축을 위하여 테마와 slot 개념을 가지고 있습니다.

테마

프로젝트 루트에 위치한 /theme폴더 안에는 다양한 테마를 포함하고 있습니다. 테마는 모든 사이트를 래핑하며, 동일한 컨셉의 사이트를 생성하고 일관성을 유지할 수 있습니다.

www-slot

/resources/www 폴더가 추가됩니다. 지니PHP는 정적페이지를 url과 동일하게 매핑하여 자동으로 페이지를 출력합니다. 또한, slot을 적용하시면 /resources/www/slot1 을 접근 endpoint로 변경하여 페이지를 출력하게 됩니다.

기술문서