Composer로 설치

앱 스타터
Latest Dev
기존 프로젝트에 CodeIgniter4 추가
번역된 시스템 메시지 설치

Composer는 CodeIgniter4를 시스템에 여러 가지 방법으로 설치하여 사용할 수 있게해 줍니다.

첫 번째 기술은 CodeIgniter4를 사용하여 새 웹앱의 기반으로 사용할 수 있는 스켈레톤(skeleton) 프로젝트를 만드는 방법을 설명합니다. 두 번째 기술을 사용하면 CodeIgniter4를 기존 웹앱에 추가할 수 있습니다.

Note

만약 당신이 코드를 저장하거나 다른 사람들과 협업하기 위해 Git 저장소를 사용한다면, vendor 폴더는 일반적으로 “git ignored”에 추가됩니다. 이 경우 레파지토리(repository)에 있는 새 시스템으로 업그레이드 하고 싶다면 composer update를 실행하십시오.

앱 스타터 

CodeIgniter 4 app starter 레파지토리는 프레임워크의 최신 버전에 대한 composer 의존성과 함께 골격(skeleton) 어플리케이션을 보유하고 있습니다.

이 설치 방법은 새로운 CodeIgniter4 기반 프로젝트를 시작하고자 하는 개발자에게 적합합니다.

설치 

프로젝트 루트(root) 폴더에서 다음과 같이 입력합니다.

> composer create-project codeigniter4/appstarter project-root

위와 같이하면 “project-root” 폴더가 생성됩니다.

“project-root”를 생략하면 “appstarter” 폴더가 생성되며, 이 폴더의 이름은 바꿀 수 있습니다.

Note

CodeIgniter 자동 로더(autoloader)는 특정 운영 체제의 파일 이름에 잘못된 특수 문자를 허용하지 않습니다. 사용할 수 있는 기호는 /, _, ., :, \과 공백(space)입니다. 따라서 (, ) 등과 같은 특수 문자가 포함된 폴더에 CodeIgniter를 설치하면 CodeIgniter가 작동하지 않습니다.

phpunit과 관련된 composer 종속성이 필요하지 않다면 위 명령에 ---no-dev 옵션을 추가합니다.

---no-dev 옵션이 추가된 경우 composer는 프레임워크에 필요한 세 가지 신뢰할 수 있는 의존성 패키지만 설치합니다.

기본 프로젝트 폴더를 “appstarter”로 지정 하는 설치

composer create-project codeigniter4/appstarter --no-dev

Initial Configuration 

설치 후 몇 가지 초기 구성이 필요합니다. 자세한 내용은 초기 구성 및 설정을 참조하세요.

업그레이드 

새 릴리즈가 있을 때마다 프로젝트 루트에서 다음 입력합니다.

> composer update

업그레이드 지침을 읽고 변경 사항 및 개선 사항을 확인하십시오.

장점 

간단한 설치; 쉬운 업데이트.

단점 

업데이투 후 project space (root, app, public, writable) 에서 변경 사항을 확인해야 합니다.

구조 

설정 후 프로젝트의 폴더:

app, public, tests, writable
vendor/codeigniter4/framework/system

Latest Dev 

App Starter 저장소에는 현재 안정 릴리스와 프레임워크의 최신 개발 지점간에 Composer 소스를 전환하는 builds 스크립트가 제공됩니다. 불안정할 수 있지만 출시되지 않은 최신 변경 사항을 적용해보고 싶은 개발자는 이 스크립트를 사용하십시오.

개발 사용자 가이드는 온라인으로 액세스 할 수 있습니다. 이는 릴리스된 사용자 가이드와 다르며 개발 브랜치와 관련이 있다는 점을 유의하십시오.

프로젝트 루트(root) 폴더에서 다음 명령을 입력하십시오.

> php builds developmen

위의 명령은 composer.json을 업데이트하여 작업 저장소의 develop 브렌치(branch)를 가리키고 구성 및 XML 파일의 해당 경로를 업데이트합니다.

이러한 변경 사항을 되돌리려면 다음 명령을 입력하십시오.

> php builds release

builds 명령을 사용한 후에는 반드시 composer update를 실행하여 vendor 폴더를 최신 빌드와 동기화해야 합니다.

기존 프로젝트에 CodeIgniter4 추가 

“수동 설치”에 설명된 것과 동일한 CodeIgniter4 프레임워크를 Composer를 사용하여 기존 프로젝트에 추가할 수도 있습니다.

Installation 

앱은 app 폴더 안에서 개발하고, 웹 루트(root)는 public 폴더를 지정하십시오.

프로젝트 루트(root)에서 다음 명령어를 입력하십시오.

> composer require codeigniter4/framework

설정(Setup)

app, public, tests, writable 폴더를 vendor/codeigniter4/framework에서 프로젝트 루트(root)로 복사

env, phpunit.xml.dist, spark 파일을 vendor/codeigniter4/framework에서 프로젝트 루트로 복사

app/Config/Paths.php의 $systemDirectory 속성을 조정하여 공급업체를 참조(예: ROOTPATH . '/vendor/codeigniter4/framework/system')합니다.

Initial Configuration 

몇 가지 초기 구성이 필요합니다. 자세한 내용은 초기 구성 및 설정을 참조하세요.

업그레이드 

새 릴리즈가 있을 때마다 프로젝트 루트의 커맨드 라인에서 다음 명령을 입력하십시오.:

> composer update

업그레이드 지침을 읽고 변경 사항 및 개선 사항을 확인하십시오.

app, public, tests, writable
vendor/codeigniter4/framework/system

번역된 시스템 메시지 설치 

번역된 시스템 메시지를 이용하려면 프레임워크 설치와 비슷한 방식으로 프로젝트에 추가할 수 있습니다.

프로젝트 루트(root)에서 다음 명령을 입력하십시오.

> composer require codeigniter4/translations

업데이트된 내용은 composer update를 실행할 때마다 프레임워크와 함께 업데이트됩니다.