Composer 설치

Composer를 사용하여 시스템에 CodeIgniter4를 설치하는 방법은 두 가지가 있습니다.

중요

CodeIgniter4는 Composer 2.0.14 이상이 필요합니다.

참고

Composer에 익숙하지 않다면 기본 사용법을 먼저 읽어보는 것을 권장합니다.

첫 번째 기술은 CodeIgniter4를 사용하여 스켈레톤 프로젝트(App Starter)를 생성하고 이를 새로운 웹 앱의 기반으로 사용하는 방법을 설명합니다. 아래에 설명된 두 번째 기술은 기존 웹 앱에 CodeIgniter4를 추가하는 방법을 설명합니다.

참고

코드를 저장하거나 다른 사람과 협업하기 위해 Git 저장소를 사용하는 경우, vendor 폴더는 일반적으로 “git ignored” 상태여야 합니다. 이러한 경우 저장소를 새로운 시스템에 복제할 때 composer install(또는 모든 Composer 의존성을 업데이트하려면 composer update)을 실행해야 합니다.

App Starter

CodeIgniter 4 App Starter 저장소는 프레임워크의 최신 출시 버전에 대한 Composer 의존성을 가진 스켈레톤 애플리케이션을 담고 있습니다.

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

설치

프로젝트 루트 상위 폴더에서:

composer create-project codeigniter4/appstarter project-root

위의 명령은 project-root 폴더를 생성합니다.

“project-root” 인자를 생략하면 명령은 “appstarter” 폴더를 생성하며, 필요에 따라 이름을 변경할 수 있습니다.

참고

v4.4.0 이전의 CodeIgniter 오토로더는 특정 운영체제의 파일 이름에서 허용되지 않는 특수 문자를 허용하지 않았습니다. 사용할 수 있는 기호는 /, _, ., :, \ 및 공백이었습니다. 따라서 \ (, ) 등과 같은 특수 문자가 포함된 폴더 아래에 CodeIgniter를 설치하면 작동하지 않았습니다. v4.4.0부터 이 제한이 제거되었습니다.

중요

운영 서버에 배포할 때는 다음 명령을 실행하는 것을 잊지 마세요:

composer install --no-dev

위의 명령은 운영 환경에서 필요하지 않은 개발 전용 Composer 패키지를 제거합니다. 이는 vendor 폴더의 크기를 크게 줄여줍니다.

이전 버전 설치

예를 들어, v4.5.0이 출시된 후 v4.4.8을 설치하고 싶을 수 있습니다.

이 경우 명령에 버전을 지정합니다:

composer create-project codeigniter4/appstarter:4.4.8 project-root

그런 다음 프로젝트 루트 폴더의 composer.json을 열고 프레임워크 버전을 지정합니다.

"require": {
    ...
    "codeigniter4/framework": "4.4.8"
},

그런 다음 composer update 명령을 실행합니다.

참고

composer.json에서 "codeigniter4/framework": "4.4.8"과 같이 고정된 버전 번호를 사용하면 composer update 명령이 프레임워크를 최신 버전으로 업데이트하지 않습니다. 버전을 지정하는 방법은 Writing Version Constraints를 참조하세요.

초기 설정

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

업그레이드

새로운 출시가 있을 때마다 프로젝트 루트의 명령줄에서 다음을 실행합니다:

composer update

업그레이드 지침 및 변경 로그를 읽고 호환성이 중단되는 변경 사항(Breaking Changes)과 개선 사항을 확인하세요.

특정 버전으로 업그레이드

예를 들어, v4.5.0이 출시된 후 v4.4.7에서 v4.4.8로 업그레이드하고 싶을 수 있습니다.

이 경우 프로젝트 루트 폴더의 composer.json을 열고 프레임워크 버전을 지정합니다.

"require": {
    ...
    "codeigniter4/framework": "4.4.8"
},

그런 다음 composer update 명령을 실행합니다.

참고

composer.json에서 "codeigniter4/framework": "4.4.8"과 같이 고정된 버전 번호를 사용하면 composer update 명령이 프레임워크를 최신 버전으로 업데이트하지 않습니다. 버전을 지정하는 방법은 Writing Version Constraints를 참조하세요.

장점

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

단점

업데이트 후 프로젝트 공간(루트, app, public, writable)의 파일 변경 사항을 확인하고 병합해야 합니다.

참고

프로젝트 공간의 변경 사항 병합을 도와주는 서드파티 CodeIgniter 모듈이 있습니다: Packagist에서 탐색.

구조

설정 후 프로젝트의 폴더 구조:

  • app, public, tests, writable

  • vendor/codeigniter4/framework/system

최신 개발 버전

App Starter 저장소에는 프레임워크의 현재 안정 릴리스와 최신 개발 브랜치 사이에서 Composer 소스를 전환하는 builds 스크립트가 포함되어 있습니다. 불안정할 수 있는 최신 미출시 변경 사항을 사용하려는 개발자를 위해 이 스크립트를 사용하세요. 이를 통해 버그를 찾고 새로운 기능을 개선하는 데 도움을 줄 수 있습니다.

개발 사용자 가이드는 온라인에서 접근할 수 있습니다. 이는 출시된 사용자 가이드와 다르며, 개발 브랜치에 명시적으로 해당된다는 점에 유의하세요.

스크립트를 실행하기 전에 변경될 파일 목록인 $files를 확인하세요. 이는 코드에서 프레임워크 디렉터리를 언급하는 추가 위치가 있을 때 유용합니다.

참고

프로젝트의 프레임워크 버전에 의존해서는 안 됩니다. 개발 코드에는 잘못된 버전 번호가 포함될 수 있습니다.

최신 개발 버전으로 업데이트

프로젝트 루트에서:

php builds development

위의 명령은 composer.json을 작업 저장소의 develop 브랜치를 가리키도록 업데이트하고, 설정 및 XML 파일의 해당 경로를 업데이트합니다.

builds 명령을 사용한 후 반드시 composer update를 실행하여 vendor 폴더를 최신 대상 빌드와 동기화하세요. 그런 다음 이전 버전에서 업그레이드을 확인하고 필요한 경우 프로젝트 파일을 업데이트하세요.

다음 마이너 버전

다음 마이너 버전 브랜치를 사용하려면:

php builds next

composer update를 실행하여 vendor 폴더를 최신 대상 빌드와 동기화하세요. 그런 다음 업그레이드 가이드 (user_guide_src/source/installation/upgrade_{version}.rst)를 확인하고 필요한 경우 프로젝트 파일을 업데이트하세요.

안정 릴리스로 되돌리기

변경 사항을 되돌리려면 다음을 실행하세요:

php builds release

기존 프로젝트에 CodeIgniter4 추가

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

설치

app 폴더 안에서 앱을 개발하고, public 폴더가 문서 루트가 됩니다.

프로젝트 루트에서:

composer require codeigniter4/framework

중요

운영 서버에 배포할 때는 다음 명령을 실행하는 것을 잊지 마세요:

composer install --no-dev

위의 명령은 운영 환경에서 필요하지 않은 개발 전용 Composer 패키지를 제거합니다. 이는 vendor 폴더의 크기를 크게 줄여줍니다.

설정

  1. vendor/codeigniter4/framework에서 app, public, tests, writable 폴더를 프로젝트 루트에 복사하세요.

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

  3. app/Config/Paths.php의 $systemDirectory 속성을 vendor 경로를 참조하도록 조정해야 합니다. 예: __DIR__ . '/../../vendor/codeigniter4/framework/system'.

초기 설정

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

업그레이드

새로운 출시가 있을 때마다 프로젝트 루트의 명령줄에서 다음을 실행합니다:

composer update

업그레이드 지침 및 변경 로그를 읽고 호환성이 중단되는 변경 사항(Breaking Changes)과 개선 사항을 확인하세요.

특정 버전으로 업그레이드

예를 들어, v4.5.0이 출시된 후 v4.4.7에서 v4.4.8로 업그레이드하고 싶을 수 있습니다.

이 경우 프로젝트 루트 폴더의 composer.json을 열고 프레임워크 버전을 지정합니다.

"require": {
    ...
    "codeigniter4/framework": "4.4.8"
},

그런 다음 composer update 명령을 실행합니다.

장점

비교적 간단한 설치, 쉬운 업데이트.

단점

업데이트 후 프로젝트 공간(루트, app, public, writable)의 파일 변경 사항을 확인해야 합니다.

참고

프로젝트 공간의 변경 사항 병합을 도와주는 서드파티 CodeIgniter 모듈이 있습니다: Packagist에서 탐색.

구조

설정 후 프로젝트의 폴더 구조:

  • app, public, tests, writable

  • vendor/codeigniter4/framework/system

번역 설치

시스템 메시지 번역을 활용하려면 비슷한 방법으로 프로젝트에 추가할 수 있습니다.

프로젝트 루트의 명령줄에서:

composer require codeigniter4/translations

vendor/codeigniter4/translations/Language 폴더의 내용을 app/Language 폴더에 복사하세요. 이 파일들은 composer update를 실행할 때마다 프레임워크와 함께 업데이트됩니다.