애플리케이션 관리

기본적으로 CodeIgniter는 app디렉터리에서 빌드하는 하나의 애플리케이션만 관리한다고 가정합니다. 하지만 하나의 CodeIgniter 설치를 여러 애플리케이션 세트가 공유하도록 구성하거나, 애플리케이션 디렉터리의 이름을 바꾸거나 위치를 옮길 수도 있습니다.

애플리케이션 디렉터리 이름 변경 또는 위치 이동

애플리케이션 디렉터리의 이름을 바꾸거나 프로젝트 루트가 아닌 서버의 다른 위치로 옮기려면, 기본 app/Config/Paths.php를 열어 $appDirectory변수(약 45번째 줄)에 전체 서버 경로를 설정하세요:

<?php

namespace Config;

class Paths
{
    // ...

    public string $appDirectory = '/path/to/your/app';

    // ...
}

Paths설정 파일을 찾을 수 있도록 프로젝트 루트의 추가 파일 두 개도 수정해야 합니다:

  • spark는 명령줄 앱을 실행합니다.

    require FCPATH . '../app/Config/Paths.php';
// ^^^ Change this line if you move your application folder

  • public/index.php는 웹앱의 프론트 컨트롤러입니다.

    require FCPATH . '../app/Config/Paths.php';
// ^^^ Change this line if you move your application folder

하나의 CodeIgniter 설치로 여러 애플리케이션 실행

공통 CodeIgniter 프레임워크 설치를 여러 애플리케이션에서 공유하려면, 애플리케이션 디렉터리 안에 있는 모든 디렉터리를 각각의 (하위) 디렉터리로 옮기면 됩니다.

예를 들어 blog와 shop이라는 두 애플리케이션을 만들고 싶다면, 애플리케이션 프로젝트 디렉터리를 다음과 같이 구성할 수 있습니다:

blog/
    app/
    public/
    tests/
    writable/
    env
    phpunit.dist.xml
    spark
shop/
    app/
    public/
    tests/
    writable/
    env
    phpunit.dist.xml
    spark
vendor/
    autoload.php
    codeigniter4/framework/
composer.json
composer.lock

참고

Zip 파일에서 CodeIgniter를 설치한 경우 디렉터리 구조는 다음과 같습니다:

blog/
shop/
codeigniter4/system/

이렇게 하면 blog와 shop두 앱이 표준 애플리케이션 디렉터리와 public폴더를 각각 가지면서, 공통 codeigniter4/framework를 공유하게 됩니다.

각 앱의 app/Config/Paths.php에 있는 $systemDirectory변수는 공유되는 codeigniter4/framework폴더를 가리키도록 설정합니다:

<?php

namespace Config;

class Paths
{
    // ...

    public $systemDirectory = __DIR__ . '/../../../vendor/codeigniter4/framework/system';

    // ...
}

그리고 각 앱의 app/Config/Constants.php에서 COMPOSER_PATH상수도 수정합니다:

<?php

defined('COMPOSER_PATH') || define('COMPOSER_PATH', ROOTPATH . '../vendor/autoload.php');

참고

Zip 파일에서 CodeIgniter를 설치한 경우 $systemDirectory는 __DIR__ . '/../../../codeigniter4/system'가 됩니다. Composer를 사용하지 않는다면 COMPOSER_PATH를 수정할 필요가 없습니다.

애플리케이션 디렉터리를 변경한 경우에만 애플리케이션 디렉터리 이름 변경 또는 위치 이동를 참고하여 index.php와 spark의 경로를 수정하세요.

.env 파일 위치 변경

필요하면 app/Config/Paths.php의 $envDirectory속성을 조정해 .env파일 위치를 변경할 수 있습니다.

기본적으로 프레임워크는 app/디렉터리에서 한 단계 위(ROOTPATH)에 있는 .env파일에서 환경 설정을 로드합니다. 권장 사항대로 도메인이 public/디렉터리를 올바르게 가리키는 경우 이 위치는 안전합니다.

하지만 실제로는 일부 애플리케이션이 메인 도메인이 아닌 하위 디렉터리(예: http://example.com/myapp)에서 서비스됩니다. 이런 경우 .htaccess나 기타 보호 설정이 잘못되면 ROOTPATH내의 .env파일이 민감한 구성 데이터를 노출할 수 있습니다.

이런 설정에서 위험을 피하려면 .env파일을 웹에서 접근 가능한 디렉터리 밖에 두는 것을 권장합니다.

경고

.env파일 위치를 변경한다면 외부에서 절대 접근할 수 없도록 반드시 확인하세요. 이 파일이 노출되면 자격 증명이 유출되고 데이터베이스, 메일 서버, 서드파티 API 같은 핵심 서비스 접근 권한이 침해될 수 있습니다.