PHP 프레임워크 – CodeIgniter – 1 – CodeIgniter 설치와 구성

작성자 wooah
PHP 프레임워크 - CodeIgniter - 1 - CodeIgniter 설치와 구성
PHP 프레임워크 – CodeIgniter – 1 – CodeIgniter 설치와 구성

PHP 프레임워크 – CodeIgniter – 설치와 구성

안녕하세요, 여러분 😊
이번 글에서는 본격적으로 CodeIgniter 프레임워크를 설치하고 개발을 시작할 준비를 해보겠습니다!
마치 요리를 시작하기 전 냄비와 도마, 재료를 하나하나 준비하는 과정과 같아요.
CodeIgniter는 가볍고 빠른 프레임워크답게 설치 방법도 정말 간단하답니다!
지금부터 함께 천천히 따라해보세요!

1. CodeIgniter 설치 방법 개요

CodeIgniter는 크게 두 가지 방법으로 설치할 수 있어요:

설치 방법 설명
수동 다운로드 공식 웹사이트에서 직접 ZIP 파일 받아서 설치
Composer 이용 최신 버전 설치 및 의존성 자동 관리 가능

개발을 더 유연하게 하고 싶다면 Composer 설치를 추천드릴게요!

2. 설치 전 준비사항

필수 준비물:

  • PHP 7.2 이상 (최신은 PHP 8.x 권장)
  • Apache, Nginx 또는 PHP 내장 웹서버
  • MySQL, PostgreSQL 등 데이터베이스 (옵션)
  • Composer (https://getcomposer.org)

설치 확인 방법

php -v           # PHP 버전 확인
composer -V      # Composer 설치 확인

3. Composer로 CodeIgniter 설치하기

1) 프로젝트 디렉터리 생성

composer create-project codeigniter4/appstarter myapp
  • myapp은 여러분의 프로젝트 폴더 이름입니다.
  • 설치가 완료되면 아래 구조로 파일이 구성돼요:
myapp/
├── app/
├── public/
├── system/
├── writable/
├── env
└── composer.json

2) 개발 서버 실행

cd myapp
php spark serve
  • 기본 포트 localhost:8080 으로 접속 가능!
  • 웹브라우저에서 http://localhost:8080 입력해보세요.
  • CodeIgniter의 환영 메시지가 뜨면 성공입니다 🎉

4. 수동 설치 방법 (ZIP 다운로드)

  1. 공식 홈페이지 접속
  2. Download CodeIgniter 버튼 클릭
  3. 압축 풀고 웹서버 루트 디렉토리(예: htdocs, www)에 옮기기
  4. .htaccess 파일이 올바르게 설정되어 있는지 확인

주의: 수동 설치 시 public/ 디렉토리를 루트로 설정해줘야 보안상 안전합니다!

5. 주요 폴더 설명

디렉토리 역할
app/ 여러분의 코드가 들어가는 공간 (컨트롤러, 모델, 뷰 등)
public/ 웹 루트 디렉토리 (index.php가 여기에 있음)
system/ 프레임워크 코어 파일 (수정❌)
writable/ 로그, 캐시, 업로드 등 쓰기 가능한 공간
env 환경변수 설정 파일 (.env로 이름 변경 필요)

6. .env 파일 구성 (환경 설정)

env 파일을 .env로 이름을 바꾸고 아래처럼 설정하세요:

CI_ENVIRONMENT = development

app.baseURL = 'http://localhost:8080'

database.default.hostname = localhost
database.default.database = my_db
database.default.username = root
database.default.password = ''
database.default.DBDriver = MySQLi

.env는 프로젝트 환경을 설정하는 매우 중요한 파일이에요!
로컬 개발 환경에서는 development, 배포 시에는 production으로 변경하세요.

7. 기본 라우팅 확인하기

app/Controllers/Home.php 파일을 확인해보세요.

namespace App\Controllers;

class Home extends BaseController
{
    public function index()
    {
        return view('welcome_message');
    }
}

기본 URL로 접속하면 welcome_message.php 뷰가 보이는 구조입니다.

8. URL 주소 설정 (mod_rewrite)

Apache를 사용 중이라면 .htaccess 설정이 필요합니다.

public/.htaccess 파일이 아래처럼 되어 있는지 확인:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

이 설정이 있어야 index.php 없이도 깨끗한 URL 사용이 가능해요!

9. 프레임워크 구조 미리보기

요소 위치 예시 파일명
컨트롤러 app/Controllers Blog.php
뷰 app/Views blog_view.php
모델 app/Models BlogModel.php
라우트 설정 app/Config/Routes.php Route::get()

10. 설치 후 첫 설정 체크리스트 ✅

  • [ ] php spark serve 명령어로 서버 정상 실행되는지 확인
  • [ ] .env 파일에서 환경 변수 제대로 설정했는지 확인
  • [ ] public/ 폴더를 웹 루트로 설정했는지 확인
  • [ ] app/Controllers/Home.php가 기본 라우트인지 확인
  • [ ] writable/ 폴더 권한이 쓰기 가능인지 확인

마무리하며 😊

CodeIgniter의 설치와 구성은 정말 간단하면서도 탄탄하게 준비되어 있어요.
이제 기초 설치는 끝났으니, 다음 단계에서는 라우팅과 컨트롤러를 직접 작성해보면서
실제 웹 애플리케이션을 만드는 재미를 본격적으로 느껴보실 수 있을 거예요!

다음 글에서는 CodeIgniter의 라우팅 시스템에 대해 알아볼게요~
그럼 지금까지 잘 따라오신 여러분, 정말 고생 많으셨어요!
오늘도 즐거운 개발 되세요~ 😊🧑‍💻✨🚀

답글 남기기