奎 :: 닿지 않아도 볼 수 있다면

Javascript 에서 cp949 를 유니코드 문자열로 변환하기

LazyGyu — Fri, 11 May 2012 07:35:30 +0900

최근에 개인적으로 JS 로 rtf 파일을 파싱하는 걸 만들고 있는데 rtf 파일은 한글을 cp949로 표현하기 때문에 js 에서 직접 한글을 뿌려줄 수가 없어서 이리저리 고민하다가 걍 cp949 코드 테이블을 js 로 만들어서 1:1 매핑하는 방식으로 해결했다.

rtf 파서보다 이쪽이 웹개발자들에게 더 많이 도움이 될 거 같아서 따로 프로젝트를 분리했다. ( 별 내용은 없는 거지만.. )

https://github.com/lazygyu/CP949-to-Unicode-converter

걍 js 파일 하나 있으니까 그거 다운받아서 쓰면 된다.

사용법도 간단하니까 자세한 설명은 생략하겠츰.

Learning the Yii Framework 6 / 8

LazyGyu — Tue, 06 Mar 2012 15:13:22 +0900

Yii 기본 모델 편집하기

이 문서는 Yii 프레임워크 배우기 시리즈의 8편중 여섯 번째 문서입니다. 원본 글은 http://www.larryullman.com/2009/11/10/basic-model-edits-in-yii/ 에서 보실 수 있습니다.

이 글은 제가 가장 좋아하는 PHP 프레임워크인 Yii 에 관한 여섯번째 글입니다. 첫번째 글에서는 어떻게 Yii 를 다운로드하고 테스트하는 지 보여드렸고, 두 번째 글에서는 기본적인 웹 어플리케이션을 생성하는 방법을 설명했습니다. 세 번째 글에서는 설정을 변경하는 방법을 보여드렸고 네 번째 글에서는 Yii 에서 사용할 데이터베이스를 디자인해 보았습니다. 다섯번째 글에서 어떻게 Gii 툴을 사용해서 모델, 뷰, 컨트롤러를 생성하는지 보여드렸죠. 이번 글에서는 Gii 툴로 생성된 모델을 입맛에 맞게 수정하는 방법을 보여 드릴것입니다. 이 과정을 통해 Yii 모델 전반에 관한 정보를 얻을 수 있을 것입니다. 코드를 보여드리기 위해서 지난 게시물들에서 생성한 직원 관리 프로그램을 사용할 것입니다. 이에 관한 정보를 다시 얻고 싶으시면 지난 게시물들을 참조하세요.

모델은 어플리케이션에서 사용되는 데이터를 대표합니다. 일반적으로 데이터들은 데이터베이스에서 가져오지만 그 외의 조작을 통해서도 데이터를 받을 수 있습니다(Yii 기본 어플리케이션에 있는 ContactForm 모델처럼 저장되지 않고 메일로만 발송되는 데이터 같은 예가 있겠네요). Yii 에서 데이터베이스 테이블에 기반한 모델은 기본적으로 액티브 레코드(Active Record)를 확장(extends, 다른 언어에서의 상속과 비슷한 개념입니다)한 클래스로 정의됩니다. 액티브 레코드는 루비 온 레일즈에서도 사용되는 보편적이고 인기있는 방식입니다. 액티브 레코드를 사용하면 데이터에 대한 실제 처리 코드를 모델 내에서 정의하지 않고 부모 클래스인 액티브 레코드에서 처리하게 됩니다. 그러니까 모델의 코드를 열었을 때 레코드를 생성하거나 업데이트하거나 뭐 요래요래 데이터를 실제로 조작하는 메소드가 없다고 해서 놀랄 필요는 없습니다. 전부 상속된 메소드들이니까요. 그런 데이터 조작과 관련된 기능들이 이미 정의되어 있기 때문에, 우리가 해야 할 일은 그저 모델을 필요에 따라 확장하고 최적화 하는 것 뿐입니다.

모델 안에는 공용으로 사용할 수 있는 Yii 전용 메소드들이 있습니다. 이 메소드들중 일부는 Gii 툴을 이용해 모델을 생성할 때 만들어집니다. 언제든 다른 메소드를 추가할 수도 있구요. 저는 여기서 대부분의 모델들에 공통적으로 존재하는 이 Yii 전용 메소드들을 중점적으로 다룰 생각입니다. (이후 글에서 모델에 추가할 수 있는 사용자 지정 메소드를 작성하는 예제를 보여드릴겁니다)

rules() 메소드는 엄청 중요한 메소드들 중 하나로, 모델의 데이터들이 준수해야 하는 규칙들의 목록을 가지고 있습니다. 어플리케이션의 보안과 신뢰도에 관한 많은 부분이 이 메소드에 기대고 있습니다. 실제로 이 메소드가 프레임 워크 내에서 대표적으로 사용되는 곳은 데이터 검증 부분입니다. 새로운 레코드를 작성하거나 기존에 있는 레코드를 갱신하려고 할 때 데이터 검증 루틴을 작성하고 복제하고 테스트할 필요가 없습니다. Yii 가 해주기 때문이죠. 모델 내의 주석이 보여주듯이, 그저 사용자가 제공하는 데이터에 사용되는 필드에 대한 규칙만 확립하면 됩니다. 예컨데 MySQL 이 생성하는 기본 키인 Employee id 필드에 대한 규칙을 설정할 필요는 없습니다.

다른 Yii 메소드들과 마찬가지로 rules() 메소드는 배열 형태의 데이터를 반환합니다.

public function rules()

{

    return array(/* actual rules */);

}

Yii 문서에 실제 규칙에 관한 내용들이 모두 나와 있습니다.(여기와 여기를 보세요). 하지만 저는 주로 사용되는 것만 조명하겠습니다. 여기서 확인할 수 있듯이 모든 규칙은 배열 형태로 반환할 수 있도록 작성됩니다.

먼저, 가장 중요한 제한은 필드가 필수적인 것인지를 표시하는 것입니다. 단순히 필드 이름들을 쉼표로 구분한 문자열을 첫번째 반환 값에 넣고 두 번째 반환 값으로 'required' 라는 단어를 넣으면 됩니다.

array('name, email, subject, body', 'required'),

데이터를 숫자만으로 제한한다거나, 좀 더 상세하게는 정수로만 제한하는 것도 가능합니다. 이런 제한을 하기 위한 문법은 위와 약간 다릅니다. 여기 ext 필드를 정수로 제한하는 예가 있습니다.

array('ext', 'numerical', 'integerOnly'=>true),

문자열의 경우에는 최대 길이를 제한 할 수 있습니다.

array('name','length','max'=>40),

혹은 최소 길이를 제한하거나

array('name','length','min'=>6),

둘 다 제한할 수도 있습니다.

array('name','length','min'=>6, 'max'=>40),

또 다른 유용한 검증 루틴으로 문자열이 이메일 주소인지 확인하는 것이 있습니다. userEmail 필드에 관해 이러한 검증을 설정해보겠습니다.

array('userEmail', 'email'),

문자열이 URL 주소여야 하는 경우에는 이렇게 할 수도 있습니다:

array('link', 'url'),

유용한 다른 규칙중에 비교 규칙이 있습니다. 예를 들어 회원 가입을 하기 위해 패스워드를 입력하고 제대로 입력했는지 확인하기 위해서 패스워드 확인 란을 입력하는 경우 등에 사용하면 좋겠죠.

array('password1', 'compare', 'compareAttribute'=>'password2', 'on'=>'register'),

"safe" 라는 규칙도 있습니다. 이 규칙은 다른 검증 루틴을 통하지 않은 데이터에 접근해야 할 때 사용됩니다. 예를 들어 이메일 필드는 이미 이메일 주소를 검증하는 루틴을 통해 검증했기 때문에 "safe" 규칙을 사용할 필요가 없습니다. 하지만 Employee 모델에는 leaveDate 라는 필드가 있는데, 이 필드에 관해서는 설정할 만한 규칙이 없습니다(이 것은 부분적으로는 날짜에 적용할만한 규칙이 없기 때문이기도 하고, 또 한 편으로는 이 필드가 NULL 값일 수도 있기 때문이기도 합니다). 이 값에 접근을 가능하게 하려면 이 값을 "safe" 하다고 표시해줘야 합니다.

array('leaveDate', 'safe'),

"safe"로 표시해야 할 필드가 여러 개 있다면, 그냥 쉼표로 분리해서 다 적어주면 됩니다.

검색에 사용할 수 있는 필드를 설정하는 규칙도 있습니다. 기본값으로 모든 규칙들이 검색에 사용할 수 있도록 설정되어 있지만 해당 필드 목록에서 원하는 필드를 제거할 수도 있습니다.

array('id, departmentId, firstName, lastName, email, ext, hireDate, leaveDate', 'safe', 'on'=>'search'),

이러한 규칙들을 모두 적용한 Employee 모델의 rules() 메소드는 아래와 같은 모양이 될 것입니다.

public function rules()

{

    return array(

        array('departmentId, firstName, lastName, email, hireDate', 'required'),

        array('departmentId, ext', 'numerical', 'integerOnly'=>true),

        array('firstName', 'length', 'max'=>20),

        array('lastName', 'length', 'max'=>40),

        array('email', 'length', 'max'=>60),

        array('email', 'email'),

        array('leaveDate', 'safe'),

        array('id, departmentId, firstName, lastName, email, ext, hireDate, leaveDate', 'safe', 'on'=>'search'),

 );

}

계속해서, 또 다른 중요한 모델 메소드는 바로 relations() 입니다. 이 메소드는 모델들 간의 관계를 나타냅니다. 데이터 베이스를 제대로 설계했다면 이 메소드는 이미 적절하게 작성되어 있을 것입니다. Gii 툴 덕분이죠. 아래에 Employee 모델의 relations() 메소드는 아래와 같을 겁니다.

public function relations()

{

    return array('department' => array(self::BELONGS_TO, 'Department', 'departmentId') );

}

관계 설정은 이름을 반홥합니다. 여기서는 department 네요. 이 관계 설정은 Employee 모델의 departmenntId 컬럼이 Department 모델에 속해있다는 것을 나타냅니다. 이러한 관계 설정이 어떻게 작동할까요? 특정한 고객에 대한 정보를 불러들일 때에는 해당 정보의 관계 설정도 함께 불러들이게 됩니다. 그렇게 함으로써 department 에 관한 참조는 Department 모델의 레코드에 대한 참조와 같이 취급됩니다. 따라서 Employee 모델을 나타내는 $model 객체가 있을 때에, $model->department->name 을 참조하게 되면 해당 직원이 속해있는 분류의 이름을 가져오게 됩니다.

Department 모델 내에서는 이 관계가 아래처럼 설정되어 있습니다.

public function relations()

{

    return array('employees' => array(self::HAS_MANY, 'Employee', 'departmentId') );

}

따라서 Department 모델을 나타내는 $model 객체가 있을 경우 $model->employees 는 해당 분류에 속해있는 모든 Employee 객체의 배열을 나타내게 됩니다.

각 모델들 간의 관계 설정은 복합적인 MVC 사이트의 핵심적인 요소입니다. 제대로 정의된 관계 설정을 통해서 컨텐츠들을 정확히 참조할 수 있게 됩니다. 이후에 이어질 두 개의 글에서 이에 관해 조금 더 배워보도록 하겠습니다.

조금 사소하지만 멋진 것들을 살펴볼까요? attributeLabels() 라는 메소드가 있습니다. 이 메소드는 폼, 에러메시지, 그 외 필요한 곳에서 사용될 각 필드의 이름을 담고 있는 배열을 반환합니다. Yii 프레임워크는 이 이름들을 멋지게 자동으로 생성해줍니다. firstName 은 First Name 으로, departmentId 는 Department 로 변환하는 식으로 말이죠. 그래도 이 이름들을 직접 설정하고 싶어질 수 있습니다. Employee 모델의 경우 저는 아래와 같이 설정했습니다.

public function attributeLabels()

{

    return array(

        'id' => 'Employee ID',

        'departmentId' => 'Department',

        'firstName' => 'First Name',

        'lastName' => 'Last Name',

        'email' => 'Email',

        'ext' => 'Ext',

        'hireDate' => 'Hire Date',

        'leaveDate' => 'Leave Date',

    );

}

이제 모델에 관해 어느 정도 기초적인 수준의 커스터마이징을 해 보았습니다. 아까도 말했듯이 나중에 자신만의 메소드를 모델에 추가할 수 있습니다. 그리고 이 글에서 살펴본 것 외에도 자주 사용하는 Yii 메소드들이 몇 개 있습니다. 모델이 저장되기 전에 자동으로 호출하는 beforeSave() 메소드라던지, 필드 값 검증을 하기 전에 호출되는 beforeValidate() 메소드 같은 것들이죠. 이 메소드들은 모델에서 값 검증을 하기 전에 보이지 않는 처리를 하거나 값들을 변경할 필요가 있을 경우 유용하게 사용됩니다. 또 search() 메소드가 있는데 이 메소드는 나중에 다른 글에서 별도로 다루겠습니다. 어쨌든 모델 내에서 가장 중요하게 사용되는 메소드는 rules() 와 relations() 메소드라는 걸 기억합시다!

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.

이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

Learning the Yii Framework 5 / 8

LazyGyu — Thu, 01 Mar 2012 19:46:46 +0900

Yii 에서 모델, 뷰, 컨트롤러 만들기

이 문서는 Yii 프레임워크 배우기 시리즈의 8편중 다섯 번째 문서입니다. 원본 글은 http://www.larryullman.com/2009/11/07/creating-models-views-and-controllers-in-yii-2/ 에서 보실 수 있습니다.

이 글은 제가 가장 좋아하는 PHP 프레임워크인 Yii 에 관한 시리즈의 다섯번째 편입니다. 첫번째 글에서는 어떻게 Yii 를 다운로드 하고 테스트 하는지를 보여드렸고, 두 번째 글에서는 기본적인 웹 어플리케이션을 만드는 방법을 설명했습니다. 세 번째 글에서는 옵션들을 설정하는 방법을 보여드렸고, 네 번째 글에서는 이 글과 이후의 글에서 만들 샘플 어플리케이션을 위한 데이터 베이스 디자인을 설명했습니다. 이번 글에서는 Gii 도구를 사용해서 어떻게 모델, 뷰, 컨트롤러를 만드는지 보여드리겠습니다. 이 글에서는 이미 이전 글들을 통해 만들어진 어플리케이션이 있다는 것을 전제로 하고 있습니다. 혹시 아직 만들어진 어플리케이션이 없다면 이전 글들을 참고해 주세요.

Yii 나 루비 온 레일즈와 같은 몇몇 프레임워크들은 코드와 파일, 디렉토리를 생성하는 도구를 가지고 있습니다. 이러한 도구는 시간을 굉장히 많이 아낄 수 있게 해줍니다. Yii 는 기본적으로 명령줄 도구인 yiic 를 통해 이런 작업을 제공했습니다. (웹 어플리케이션을 생성하는 것도 같은 도구로 했었지요) Yii 1.1.2 버전 이후로 브라우저를 통한 웹 기반의 Gii 라는 툴이 추가되었습니다. 이번 글에서는 Gii 를 이용해서 어떻게 어플리케이션이 필요로 하는 기본적인 모델, 뷰, 컨트롤러들을 만들 수 있는지를 설명하겠습니다. (이후의 글에서는 자동으로 생성된 코드들을 어떻게 필요에 따라 수정하는지를 이야기하겠습니다.)

참고: 명령줄 도구인 yiic 를 더 선호한다면, yiic 를 여전히 사용할 수 있습니다.

이 글은 Gii 를 통해 두 개의 이미 만들어진 테이블(이전 글 참조)을 사용하는 직원 관리 예제를 시연합니다.
작업을 시작하기 전에 아래와 같은 것들을 기억합시다.

Gii 가 많은 것들을 처리해주기 때문에, 되도록이면 완전한 상태의 설계를 가지고 있는 것이 좋습니다. 제대로 준비를 해 두었다면 이후의 과정을 따라 데이터 베이스 테이블을 만들고 난 뒤에는 Gii 를 다시 사용할 필요가 없습니다.
지난 세 번째 글에서 쓴 방법을 통해 Gii 를 활성화시켜둬야 합니다.
Gii 는 강력한 툴이기 때문에, 실제로 서비스되고 있는 서버에서는 활성화하지 않는 것이 좋습니다. 이상적인 관점에서 보면 Gii 를 개발 서버에서 활성화 시키고, 사용한 뒤에 다시 비활성화하고 나서 사이트를 온라인 서비스하는 것이 좋습니다.
만약 완성된 어플리케이션을 라이브 서버에 올렸지만 커맨드 라인으로 접근할 수 없는 상태라면, 모든 부분을 로컬 컴퓨터에서 개발한 뒤에 생성된 파일들을 다시 서버에 올려도 됩니다. 다시 말하지만, 명령줄 도구는 초기 설정을 위한 겁니다.
명령줄 도구를 성공적으로 사용하는 것은 명령줄 버전 PHP 가 잘 설치되어있고 환경 설정들이 제대로 되어 있는 데에 달려있습니다. 자세한 내용은 이 시리즈의 두 번째 글을 참조하세요.
두 개의 데이터베이스 테이블이 있는지 확인하세요.
Yii 어플리케이션이 데이터베이스에 접속할 수 있도록 main.php 파일을 수정했는지 확인합시다. 자세한 내용은 세 번째 글을 참조하세요.

팁 : 보안을 강화하기 위해서 Gii 를 특별한 IP 주소에서만 실행할 수 있도록 설정할 수 있습니다. (예컨데 자신의 IP 로 설정한다던지..)

상기의 내용들을 모두 이해하고 필요한 과정을 다 거쳤다고 가정하면 이제 브라우저에서 Gii 를 로드할 차례입니다. 사이트 주소가 예를 들어 www.example.com/index.php 라면, Gii 툴은 www.example.com/index.php/gii/ 로 접근하면 됩니다. 물론 이건 Yii 의 URL 관리 컴포넌트를 사용할 경우입니다. 혹시 URL 관리 컴포넌트를 사용하지 않는다면 www.example.com/index.php?r=gii 로 접속하면 됩니다. 그러면 로그인 화면이 나올 겁니다. (패스워드는 설정 파일에 정의되어 있습니다) Gii 패스워드를 입력하고 Enter 를 클릭합시다. 패스워드를 정확히 입력했다면 스플래시 페이지와 옵션 리스트를 보게 될 겁니다.

Gii Splash Page

가장 먼저 하고 싶은 일은 아마 모델을 만드는 일일 겁니다. "Model Generator" 링크를 클릭합시다. 그 다음 페이지들에서 해야 할 일은 아래와 같습니다.

테이블 이름에 Employee 를 입력합니다.
모델 클래스에 Employee 를 입력합니다. 아마 자동으로 테이블 명과 같은 이름이 들어가 있을 겁니다.
미리보기를 클릭합니다. 생성된 파일들을 표시해주는 표가 폼 아래에 나타날겁니다. (이 경우에는 하나 뿐이겠죠)
생성을 클릭합니다.

팁 : 모든 데이터베이스 테이블에 대해 모델을 자동으로 생성하려면 테이블 이름에 그냥 * 을 넣으면 됩니다.

Generating a Model

그러면 코드가 생성되었다는 메시지가 보일겁니다. (내용을 확인 하기 위해 생성된 파일을 열어 보아도 좋습니다) 만약 파일을 쓸 수 없다는 오류가 보이면, protected/models 디렉토리의 권한 설정을 웹 서버가 쓸 수 있도록 변경해주어야 합니다. 이 작업이 끝나면 같은 작업을 Department 테이블에 대해서도 하면 됩니다.

이 단계는 protected/models/Department.php 파일과 protected/models/Employee.php 파일을 생성합니다. 이 파일들은 텍스트 에디터나 IDE 를 통해 열어보고 편집할 수 있습니다. Yii ~~1.0.10~~ 1.1.4 버전에서 생성된 모델 파일은 약 60 110 줄의 코드를 갖습니다. 다음 게시물에서는 특정 코드들에 대해 좀 더 파고들어보겠지만, 지금 파일 내에서도 모델에 대한 검증 규칙을 설정하는 메소드나 다른 모델과의 관계등을 확인할 수 있습니다.

다음은 엄청 큰 비중을 차지하는 CRUD 기능을 만들 차례입니다. CRUD 는 Create, Retrieve, Update, Delete 의 머릿글자입니다. 바꿔 말하면 데이터베이스 컨텐츠에 대해 할 수 있는 모든 작업을 의미합니다. "Crud Generator" 링크를 클릭합시다. 그리고 이후의 페이지에서 아래와 같은 작업을 합니다.

모델 클래스에 Employee 를 입력합니다.
employee 를 컨트롤러 ID 에 입력합니다. 모델 클래스의 이름이 자동으로 소문자 카멜케이스로 변경되어 컨트롤러 ID 에 입력된 것을 확인할 수 있을겁니다. 예를 들어 Employee 는 employee 로, SomeThing 은 someThing 으로 변경되어 자동으로 채워집니다.
미리보기를 클릭합니다. 자동으로 생성된 파일 목록이 들어있는 표가 폼 아래에 나타납니다.
생성을 클릭합니다.

팁 : 만일 특정 기능들이 필요하지 않다면 거기 해당하는 체크박스를 해제함으로써 해당 기능들을 제외할 수 있습니다.

코드가 생성되었다는 메시지가 표시될겁니다. 다시 말하지만, 파일을 쓸 수 없다는 오류가 나온다면 protected/controllers 와 protected/views 디렉토리의 권한을 웹 서버가 쓸 수 있도록 변경해야 합니다. 이 작업이 끝난 후에는 Department 모델에 대해서도 같은 작업을 반복합니다. 결과 페이지에서는 마찬가지로 생성된 파일들을 테스트 할 수 있는 링크를 보여줄겁니다.

Crud Generator

이 단계는 모든 모델 파일들에 대해 컨트롤러 파일(DepartmentController.php 와 EmployeeController.php)을 생성하고 추가로 각 모델에 대해 여덟개의 뷰 파일이 들어있는 디렉토리를 생성합니다.

_form.php
_search.php
_view.php
admin.php
create.php
index.php
update.php
view.php

폼 파일은 레코드를 생성하거나 업데이트 하는 데 사용됩니다. 검색 스크립트는 사용자 정의 검색 폼입니다. _view.php 파일은 개개의 레코드를 보여주기 위한 템플릿입니다. 관리자 스크립트는 CRUD 기능에 대한 링크를 가진 모델 리스트를 생성합니다. 인덱스 스크립트는 실제로 공개된 레코드 목록을 위한 파일입니다. 뷰 스크립트는 개개의 레코드에 대해 특정한 정보를 보여주기 위해 사용됩니다. create 와 update 파일들은 _form 페이지에 대한 래퍼입니다. 이 파일들은 폼에 대해 적절한 제목등을 표시하고 하나의 폼으로 각각의 기능을 수행할 수 있도록 합니다.

Yii 1.0 버전에 대해 : Yii 1.1 이전 버전에서는 view.php 파일은 show.php 파일에 의해 호출되었고 index.php 파일은 list.php 파일을 호출하도록 되어있었습니다. 뷰 파일들도 더 적게 생성되었습니다.

참고 : 늘 모든 모델에 대해 CRUD 기능이 필요한 것은 아닐 수도 있습니다. 그러므로 항상 위의 두 단계를 거칠 필요는 없습니다.

자, 됐습니다. 로그아웃을 클릭한 뒤에 webapp 을 클릭해서 다시 홈 페이지로 돌아갈 수 있습니다. 새로 생성된 디렉토리와 파일들을 직접 확인하거나 URL 을 통해 접근 할 수 있습니다. urlManager 컴포넌트를 활성화 했다면 www.example.com/index.php/employee 와 같은 형태의 URL 로 접근이 가능하고, 활성화 하지 않았다면 www.example.com/index.php?r=employee 처럼 접근할 수 있습니다. 아직 목록에 어떤 직원이나 분류도 없고, 로그인하지 않으면 추가할 수도 없습니다. 로그인을 위한 기본 아이디와 암호는 admin / admin 입니다.

다음 글에서는 어플리케이션의 동작을 실제로 원하는 대로 변경하기 위해 생성된 코드들을 편집하는 방법을 설명할 예정입니다. 하지만 Yii 의 Gii 툴이 해야 할 작업을 벌써 80% 이상 해치워준 것에 대해 감사합시다! 덕분에 작업량이 정말 많이 줄었으니까요!

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.

이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

Learning the Yii Framework 4 / 8

LazyGyu — Wed, 15 Feb 2012 22:04:16 +0900

Yii 어플리케이션용 데이터베이스 정의하기

이 문서는 Yii 프레임워크 배우기 시리즈의 8편중 네 번째 문서입니다. 원본 글은 http://www.larryullman.com/2009/11/05/creating-models-views-and-controllers-in-yii/ 에서 보실 수 있습니다.

이 글은 제가 가장 좋아하는 PHP 프레임워크인 Yii 에 대한 네 번째 글입니다. 첫 번째 포스트에서는 Yii 를 다운로드하고 테스트하는 방법을 보여드렸고, 두 번째 글에서는 기본적인 웹 어플리케이션을 만드는 방법을 설명했습니다. 세 번째 글에서는 여러 설정을 살펴보았습니다. 이번 글에서는 예제로 보여드릴 Yii 어플리케이션(이후의 글들에서 나올 겁니다)의 기초가 되는 데이터베이스 디자인을 설명하려고 합니다. 예제 어플리케이션은 전형적인 직원 관리 어플리케이션입니다. 모든 직원들은 하나의 분류에 속해 있는 형태입니다. 이 글에서는 이미 이전 글들에서 설명하고 만들어 둔 Yii 어플리케이션이 있는 상태라고 가정하겠습니다.

가상의 회사의 직원과 분류를 추가하고, 수정하고, 표시하고, 삭제하는 기능을 가진 웹 어플리케이션을 만드는 것이 이 글의 목표입니다. 이 네 가지 기능은 흔히 CRUD 라는 약자로 칭해집니다. 이는 Create(혹은 Insert), Retrieve(혹은 Select), Update, Delete 의 머릿글자입니다. 이 네 동작은 모든 종류의 컨텐츠를 관리하는 프로그램의 기본이 되는 동작입니다. 이 동작들을 하기 위해서는 직원과 각 분류에 대해 아래와 같은 파일ㄷ르을 만들어야 합니다.

각 항목을 정의하는 모델 파일
각 항목에 대해 할 수 있는 동작을 정의하는 컨트롤러 파일
아이템을 추가하거나 이미 있는 아이템을 수정하는 폼을 가진 뷰 파일

어떤 프레임워크들은 이러한 파일들을 만드는데 많은 작업들을 요구하기도 합니다. 템플릿 선택, 복사, 붙여넣기, 편집, 새 파일 만들기, 기타 등등... Yii, 혹은 루비 온 레일즈와 같은 다른 프레임워크들은 대부분 적절한 준비가 되어 있다면 포함된 툴을 실행해서 이러한 작업들을 할 수 있습니다. 시작하기 위해서 일단 먼저 모델에 대해 생각해 볼 필요가 있습니다. 이 예제의 경우에는 데이터베이스 테이블을 나타내는 모델이 되겠죠.

두 개의 테이블은 일 대 다 관계지만 상당히 간단합니다. 각각의 분류에는 많은 직원들이 포함되어 있지만 각각의 직원들은 하나씩의 분류만 가질 수 있습니다. 직원 테이블에는 어떤 것이든 넣을 수 있겠지만 이번 "Yii 프레임워크 배우기" 시리즈에서는 아래와 같은 SQL 문을 통해 정의하도록 하겠습니다.

CREATE TABLE Employee (

    id MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,

    departmentId TINYINT UNSIGNED NOT NULL

        COMMENT "CONSTRAINT FOREIGN KEY (departmentId) REFERENCES Department(id)",

    firstName VARCHAR(20) NOT NULL,

    lastName VARCHAR(40) NOT NULL,

    email VARCHAR(60) NOT NULL,

    ext SMALLINT UNSIGNED NULL,

    hireDate TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,

    leaveDate DATETIME NULL,

    INDEX name (lastName, firstName),

    INDEX (departmentId)

)

MVC에 관한 글에서 왜 프레임워크의 규칙을 따라가는 것이 좋은지 설명했었습니다. 예를 들어, 저는 평소에 개인적으로 모든 컬럼명을 소문자와 밑줄을 사용해서 정의해왔습니다. (예컨데, first_name) 하지만 여기서는 카멜 케이스를 사용했는데, Yii 나 일반적인 객체지향 코드의 컨벤션을 지키기 위해서입니다. (각각의 직원들에 대해 검색하게 되면, 각 컬럼명이 모델의 필드명으로 사용되게 됩니다. 예를 들면 $model->firstName 과 같은 식으로요.) 마찬가지로 기본 키 컬럼도 id 라는 이름으로 하도록 하겠습니다. departmentId 컬럼은 departments 테이블을 참조하는 외래키입니다. 이를 통해 각 직원이 어떤 분류에 속해 있는지 알아내게 됩니다. ext 컬럼은 직원의 내선 번호를 나타내는 컬럼입니다. (대개 저는 모델에서 여기에 대해 숫자만을 입력할 수 있도록 제한합니다) hireDate 는 레코드가 추가될 때 자동으로 채워집니다(특별히 날짜가 제공되지 않는 경우). 추측컨데, MySQL 은 버전마다 타임스탬프의 작동 방식이 바뀌는 것 같습니다. 또한 정렬을 위해서 사람들의 이름에 인덱스를 걸었고, join 연산에 사용될 departmentId 컬럼에도 인덱스를 추가했습니다.

분류 테이블에는 컬럼이 꼴랑 두 개 밖에 없습니다. 첫번째는 기본 키이고, 두번째는 분류의 이름입니다. (유니크 키가 지정되어 있습니다). 그리고 다음은 분류 구분입니다. 이 값은 직원 테이블과의 join 에 사용되기 때문에 인덱스가 걸려 있습니다. (또한, 이것은 두 개의 테이블간에 일 대 일 대응이 성립된다는 것을 뜻합니다) (노트 : 이 시리즈의 원래 버전에서는 세 번째 컬럼이 있었지만 이것이 여러 사람에게 혼란을 줘서 제거했습니다.)

CREATE TABLE Department (

    id TINYINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,

    name VARCHAR(40),

    UNIQUE (name)

)

직원 테이블에 대해 했던 이야기에서처럼 Yii 는 외래키를 인식해서 모델을 정의할 때 도움을 주는 정보로 활용합니다. 하지만 MySQL 은 외래 키에 대해 강한 제약을 두고 있지 않기 때문에 (사용하는 MySQL 의 버전이나 스토리지 엔진에 따라 다릅니다), Employee.departmentId 컬럼과 연관이 있는 것처럼 주석을 추가해서 Yii 를 속일 수 있습니다. 주석은 departmentId 컬럼이 Department 모델의 id 컬럼을 참조한다는 것을 나타냅니다. 만약 이런 주석을 추가하지 않는다고 해도 직접 그러한 관계를 나타내는 코드를 작성하면 되겠지만, Yii 가 잘 해주겠다는데 굳이 그럴 필요가 있을까요?

자, 이제 준비가 다 됐습니다. 두 개의 테이블을 만들었으면 이제 Yii 툴을 이용해서 모델, 컨트롤러, 뷰를 만들 수 있습니다. (다음 글에서 설명할 내용입니다) 그런 작업을 하기 전에, 데이터베이스 테이블을 다시 한 번 확인하고 정말 의도했던 대로 작성되었는지 확인하는 것이 좋습니다. Yii 가 자동으로 코드를 만든 뒤에 테이블 구조를 변경하게 되면 직접 많은 코드를 수정해야만 합니다. 그러므로 되도록 이 단계에서 신중하게 확인하도록 합시다.

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.

이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

Learning the Yii Framework 3 / 8

LazyGyu — Sat, 11 Feb 2012 01:09:35 +0900

Yii 설정하기

이 문서는 Yii 프레임워크 배우기 시리즈의 8편중 세 번째 문서입니다. 원본 글은 http://www.larryullman.com/2009/11/03/configuring-yii/ 에서 보실 수 있습니다.

이 글은 필자(저자인 Larry 입니다 저 아님여! - 역자 주)가 가장 좋아하는 PHP 프레임워크인 Yii 에 관한 세 번째 글입니다. 첫 번째 글에서는 Yii 를 다운로드하고 테스트하는 방법을 보여드렸습니다. 두 번째 글에서는 기본적인 웹 어플리케이션을 만드는 방법을 보여드렸죠. 그 포스트의 마지막 부분에서는 어플리케이션 디렉토리 내의 파일들과 폴더들에 대해서도 설명했습니다. 이번 글에서는, 어떻게 Yii 기반의 어플리케이션의 설정을 변경할 수 있는지, 오류를 어떻게 처리하는지, 컴포넌트들을 어떻게 추가하는지, 데이터 베이스 연결을 어떻게 수립하는 지 설명하겠습니다. 이 글은 작업을 하기 위한 어플리케이션이 이미 있다는 가정 하에 씌여졌습니다. 혹시 아직 어플리케이션을 만들지 않았다면 먼저 지난 두 개의 게시물을 읽고 어플리케이션을 생성하세요.

Yii 어플리케이션의 동작을 설정하는 데에는 크게 두 가지 방법이 있습니다. 대부분의 경우, protected/config/main.php 파일을 통해서 하게 됩니다. 하지만 먼저 어플리케이션 디렉토리에 있는 index.php 파일에 관해 이야기해야 할 것 샅습니다. 이 파일은 "부트 스트랩(이렇게 써놔도 다들 이해 하시겠죠? - 역자 주)" 파일입니다. 사용자의 모든 동작이 이 파일을 통해서 이루어집니다. 예를 들어 직원 정보를 보려면 www.example.com/index.php/employee/show/id/34 와 같은 URL 을 통해 접근하게 되고, 정보를 수정하려면 www.example.com/index.php/department/update/id/34 와 같은 URL 로 정보를 전송하는 폼을 통해 하게 됩니다. 두 URL 은 사실 실제로 같은 PHP 파일을 가리키고 있습니다.

index.php 파일은 yiic 명령을 실행할 때 생성됩니다. 단 일곱줄짜리 주석 없는 코드밖에 없는 파일이죠. Yii 프레임워크의 위치를 식별하는 부분이 첫 째 내용입니다.

$yii=dirname(__FILE__).'/../framework/yii.php';

아마 올바른 경로가 들어가 있을 겁니다. 왜냐면 프레임워크에서 어플리케이션을 생성할 때 만들어진 내용이기 때문이죠. 혹시 프레임워크의 위치를 옮기거나 index 파일의 위치를 이동하게 된다면 이 경로를 변경해도 괜찮습니다.

두 번째 줄은 설정 파일의 위치를 지정하고 있습니다.

$config=dirname(__FILE__).'/protected/config/main.php';

기본값으로 index 파일과 같은 디렉토리에 있는 protected 디렉토리가 지정되어 있습니다. 어플리케이션 파일이 모두 들어있는 디렉토리죠. 저는 이 디렉토리를 웹에서 접근할 수 없는 위치로 옮기는 것을 선호합니다. 예를 들면 아래와 같은 형태로요.

Modified Yii Layout

이런 경우에, index.php 파일을 아래와 같이 고치면 됩니다.

$config= '../protected/config/main.php';

어플리케이션의 파일을 옮기는 건 합리적인 일이지만(예컨데, protected 폴더 같은), 되도록이면 그 폴더 내의 폴더 이름이나 구조는 변경하지 않는 게 좋습니다.

팁 : protected 폴더를 웹 디렉토리 밖으로 옮기는 것은 추가적인 보안을 위한 조치입니다. 필수적인 일은 아니니까 위치를 변경하는 게 불안하다면 굳이 옮기지 않아도 괜찮습니다.

코드의 다음 줄은 디버깅 모드를 켜는 내용입니다.

defined('YII_DEBUG') or define('YII_DEBUG',true);

사이트를 개발하는 중에는 디버깅이 유용할 수 있지만 실제 서비스중에는 디버깅을 끄는 게 좋습니다. 디버깅 모드를 끄기 위해서는 해당 라인을 제거하거나 주석처리하면 됩니다. 저는 보통 주석으로 처리하는 편입니다. 나중에 디버깅 모드를 다시 켜기 간편하도록 말이죠. 혹은 아래와 같이 변경해서 각각의 페이지에 임시적으로 디버깅모드를 켤 수 있도록 할 수도 있습니다.

if (isset($_GET['debug'])) define('YII_DEBUG', true);

이렇게 해 놓으면 URL 을 다르게 접근하는 것만으로도 디버그 모드를 켤 수 있게 됩니다. 예를 들어서 www.example.com/index.php/site/contact 와 같은 경우 www.example.com/index.php/site/contact/d 로 바꾸어 접근하면 디버그모드가 활성화되는거죠.

그 다음 줄은 "콜 스택"을 몇 단계까지 메시지 로그에 보여줄 것인지 결정하는 부분입니다.

defined('YII_TRACE_LEVEL') or define('YII_TRACE_LEVEL',3);

"콜 스택"이란 어떤 파일이나 함수 등등이 포함, 실행되었는지를 나타내는 것입니다. 프레임워크를 사용하게 되면 단순히 홈페이지를 불러오기만 해도 실행되는 동작이 열 개는 가뿐히 넘게 됩니다. 저 줄을 통해서 이전에 수행된 동작에 대한 기록이 세 줄로 제한되게 됩니다.

부트 스트랩 파일의 마지막 두 줄은 프레임워크를 불러오고 어플리케이션을 실행하는 내용입니다. 이 내용을 건드려선 안됩니다!

require_once($yii);

Yii::createWebApplication($config)->run();

이게 index.php 파일에서 하는 일의 전부입니다. Yii 1.1 버전 이후로 프레임워크는 또 다른 부트스트랩 파일을 생성합니다. 바로 index-test.php 파일인데요. 이 파일은 실제로 index.php 파일과 동일한 내용입니다. 환경설정 파일을 불러오는 부분이 protected/config/main.php 파일 대신에 protected/config/test.php 파일을 가져온다는 것만 빼구요. 어찌되었건, 테스트 설정 파일은 메인 환경설정 파일을 포함하고 있습니다. 그리고 단위 테스트를 위해 CDbFixtureManager 콤포넌트를 활성화합니다. index-test.php 파일은 호출 스택 제한을 생략하고 있습니다.

protected/config 디렉토리 안에 있는 main.php 파일 내에 대부분의 설정이 들어 있습니다. config 디렉토리 내에는 console.php 라는 설정 파일도 있는데, 이 파일은 콘솔용 어플리케이션에 사용됩니다. 이에 관해서는 여기서 설명하지 않겠지만, 혹시 어플리케이션에 콘솔용 스크립트가 있다면 이 파일을 수정해야 할 수도 있습니다.

환경 설정 파일은 다차원 배열을 반환합니다. 이 배열은 미리 정의된 정보들을 포함합니다. 이 파일을 적절하게 편집하기 위해서는 특히 괄호나 구두점을 사용하는 데 주의를 기울이세요.

처음 시작하는 경우에는 기본 HTML 디자인이나 페이지 제목, 혹은 그 외에도 계속해서 사용될 어플리케이션의 이름을 변경하고 싶을겁니다.

'name'=>'Wicked Cool Yii Site',

다음으로, 모듈(modules) 섹션을 봅시다. 여기서 Gii 를 활성화시켜야 합니다. Gii 는 모델, 뷰, 컨트롤러 등을 생성하기 위해 사용하는 웹 기반의 도구입니다. Gii 를 활성화시키기 위해서는 아래 코드의 주석을 해제하기만 하면 됩니다.

'gii'=>array(

    'class'=>'system.gii.GiiModule',

    'password'=>'SECURE',

),

코드에 혼자만 알 수 있는 비밀번호를 적어 넣으세요. (SECURE 를 지우고 거기다 써 넣으면 됩니다 - 역자 주)

팁 : Gii 는 Yii 버전 1.1.2 이후로 추가되었습니다. Gii 를 이용하면 커맨드 라인 Yii 도구의 기능을 대체할 수 있습니다.

아래로 내려가서 콤포넌트(components) 섹션을 봅시다. 아마 urlManager 를 활성화시키고 싶을겁니다. 아래 코드의 주석을 제거합시다.

'urlManager'=>array(

    'urlFormat'=>'path',

    'rules'=>array(

        '<controller:w+>/<id:d+>'=>'<controller>/view',

        '<controller:w+>/<action:w+>/<id:d+>'=>'<controller>/<action>',

        '<controller:w+>/<action:w+>'=>'<controller>/<action>',

    ),

),

이 콤포넌트는 URL 을 사용자나 검색엔진이 접근하기에 좀 더 편리하게 바꿔줍니다. 예를 들어 기본적인 URL 은 www.example.com/index.php?r=site/contact 와 같은 형태지만, urlManager 는 이 주소를 www.example.com/index.php/site/contact 와 같은 형태로 바꿔줍니다. 추가로, urlManager 설정과 아파치 웹서버의 .htaccess 파일을 통해서 URL 에서 index.php 부분을 없앨 수도 있습니다.

다음으로, 대부분의 경우에 늘 데이터베이스 연결이 필요할겁니다. (물론 데이터베이스를 사용하지 않는다면 필요 없겠죠) 이를 위해서 연결을 위한 사용자 이름과 패스워드를 담고 있는 부분을 봅시다. 기본값은 SQLite 를 위한 설정이 들어있습니다.

'db'=>array(

    'connectionString' => 'sqlite:'.dirname(__FILE__).'/../data/testdrive.db',

),

SQLite 를 사용하고 싶다면 그냥 SQLite 데이터베이스 파일의 위치만 바꿔주면 됩니다. 하지만 SQLite 를 사용하지 않는다면 위 코드를 주석처리 하도록 합시다.

MySQL 을 사용하기 위해서는 아래와 같은 코드가 필요합니다.

'db'=>array(

    'connectionString' => 'mysql:host=localhost;dbname=testdrive',

    'emulatePrepare' => true,

    'username' => 'username',

    'password' => 'password',

    'charset' => 'utf8',

),

connectionString 은 정확한 형식을 맞춘 DSN(Database Source Name) 입니다. 이 문자열은 사용하려는 데이터베이스를 나타내는 키워드로 시작해야 합니다. 예를 들면 mysql, pgsql(PostgreSQL), mssql(Microsoft's SQL Server), oci(Oracle) 등입니다. 이 키워드 뒤에는 콜론(:) 이 들어가고, 사용중인 데이터베이스나 서버 환경에 따라 몇개의 파라미터가 들어갑니다. 각 파라미터는 세미콜론(;)으로 구분합니다.

mysql:host=localhost;dbname=test
mysql:port=8889;dbname=somedb
mysql:unix_socket=path/to/mysql.sock;dbname=whatever

사용할 데이터베이스를 설정하는 것은 아주 중요합니다. 제 경우(Larry 입니다. 저 아님여! - 역자 주) Mac OS X 에서 MAMP 를 사용할 때는 포트 번호를 기본값(3306)과 다른 번호로 설정해야 했습니다. Mac OS X 서버에서는 기본값과는 다른 소켓을 지정해 줘야 했습니다. 다른 데이터 베이스를 사용할 때에는 그에 맞는 PHP 확장이 설치되어 있어야 한다는 것을 기억하세요. (PDO 와 PDO MySQL 처럼요). 기존 값을 데이터베이스에 맞는 사용자 이름과 패스워드로 변경하도록 합시다. 그 외에 인코딩이나 캐릭터셋을 변경할 수도 있습니다.

로그(log) 콤포넌트 섹션에서 저는 CWebLogRoute 를 활성화했습니다. 이건 굉장히 쓸모있는 디버깅툴로, 각 페이지들에 대해 아주 많은 정보를 제공해줍니다. 아래 코드가 해당 설정 부분입니다.

'log'=>array(

    'class'=>'CLogRouter',

    'routes'=>array(

        array(

            'class'=>'CFileLogRoute',

            'levels'=>'error, warning',

        ),

        array (

            'class' => 'CWebLogRoute'

        )

    ),

),

그리고 이건 출력 예제입니다.

Web Log Output

마지막으로, 설정파일의 끝부분에서 adminEmail 부분을 찾을 수 있을겁니다. 이 부분을 자신의 메일 주소로 변경합니다. 이 주소로 에러 메시지나 의견 보내기 폼의 메시지나..뭐 그외 여러가지가 전달됩니다.

'params'=>array(

    'adminEmail'=>'whatever@example.edu',

),

콤포넌트를 추가하고 편집하는 부분이 설정의 많은 부분을 차지하고 있습니다. 제가 강조해놓은 것들은 제 생각에 중요하다고 생각되는 부분들입니다. 하지만 그 외에도 캐싱, 보안, 테마 등등 중요한 부분들이 많이 있습니다. Yii 프레임워크의 멋진 점 중 하나는 모든 요청마다 모든 컴포넌트를 로딩하지 않는다는 점입니다. 로깅 같이 항상 로딩되는 컴포넌트도 있지만, 그 외에는 필요한 경우에만 컴포넌트가 로딩됩니다. 이를 통해 많은 컴포넌트를 사용할 때에도 퍼포먼스 낭비를 최소화할 수 있습니다.

또 환경설정 파일에서 중요하게 봐야 할 부분은 기본 컨트롤러를 설정하는 부분입니다. 다르게 말하면, URL 에서 특정한 컨트롤러가 지정되지 않았다면 어떤 컨트롤러가 호출된 거냐는 이야기죠. 추가적인 설정이 없다면, "site" 컨트롤러가 기본적으로 호출됩니다. 이 부분을 다른 컨트롤러로 바꿀 수 있습니다. 아래와 같은 라인을 추가합시다.

'defaultController' => 'login',

이 설정은 해당하는 컨트롤러가 있을 경우에만 적용된다는 점을 기억합시다. 이렇게 변경하기 전에 protected/controllers/LoginController.php 파일을 먼저 만들어야 합니다. (혹은 다른 존재하는 파일을 기본 컨트롤러로 지정해도 괜찮습니다.) 마찬가지로 이 부분은 다른 섹션 아래에 존재하는 것이 아니라 다차원 배열의 가장 상위 단계에 넣어야 한다는 점도 기억해 둡시다. 간단히 "basePath" 와 "name" 항목 사이에 넣으면 확실하겠죠.

간단하게 Yii 어플리케이션을 설정하는 법을 소개해 봤습니다. 늘 제 글을(그러니까 누차 쓰지만 Larry 이야기입니다. - 역자 주) 읽어주셔서 감사합니다. 질문이나 하고 싶은 이야기가 있으시면 저에게 알려주세요. 다음 포스트에서는 이후 시리즈에서 사용될 데이터베이스를 디자인하는 방법을 설명하겠습니다. 그리고 나면 Yii 도구를 이용해서 자동으로 모델, 뷰, 컨트롤러가 생성되는 신기한 마술을 보여드리겠습니다.

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.

이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

Learning the Yii Framework 2 / 8

LazyGyu — Thu, 09 Feb 2012 02:15:45 +0900

Yii 프레임워크 시작하기

이 문서는 Yii 프레임워크 배우기 시리즈의 8 편 중 두번째 문서입니다. 원본 글은 http://www.larryullman.com/2009/10/31/getting-started-with-the-yii-framework/ 에서 보실 수 있습니다.

꽤 오래전에 Yii 프레임워크 소개 글을 썼었죠. Yii 는 PHP 5(혹은 그 이후 버전)를 이용해 웹 어플리케이션을 만드는 프레임워크입니다. 루비 온 레일즈는 제가 개인적으로 처음 사용했던 웹 개발 프레임워크입니다(2005년경) Zend 는 처음으로 사용했던 PHP 프레임워크였구요. Yii 는 많은 점에서 그것들과 비슷합니다. 하지만 저는 실제로는 Zend 를 좋아하지 않습니다. 첫번째 글에서 저는 Yii 를 단순히 다운로드하고 테스트하는 방법을 설명했었습니다. 이제 웹 어플리케이션을 실제로 작성하는 방법을 보여드리겠습니다.

구체적인 예제를 위해 저는 고객 분류를 위한 웹 어플리케이션을 사용하도록 하겠습니다. 이 어플리케이션은 분류 목록과 고객 목록을 가지고 있고, 고객들은 각각 하나의 분류에만 속하게 되어 있습니다. 전통적인 예제죠. 이해하기 쉽고, 연습에도 도움이 되고, 하나 이상의 데이터베이스 테이블을 사용하며, 다른 경우에도 적용하기 좋은 예제입니다. 일단, 어플리케이션의 틀을 만들기 위해 명령어 기반 도구를 사용하게 될 겁니다. 혹시 커맨드 라인 툴을 지원하지 않는 서버에서 Yii 를 이용한 어플리케이션을 작성하게 된다면 먼저 자신의 컴퓨터에 완전한 웹 서버를 설치해서(아파치, PHP, MySQL 등등) 아래의 단계를 수행하고, 만들어진 프로젝트를 업로드하면 됩니다. 만약 아직 컴퓨터에 웹 서버를 설치하지 않았다면 XAMPP(Windows)나 MAMP(Mac)을 추천합니다. 양쪽 다 무료이고 사용하기에도 쉽습니다.

가장 먼저 해야할 일은 최신 버전의 Yii 프레임워크를 설치하는 것입니다. 지난 첫번째 글에서 Yii 를 어떻게 얻어야 하는지 설명했었죠. 그리고 나면 framework 폴더를 서버에 위치하도록 해야 합니다. 이 폴더를 반드시 웹 디렉토리에 넣을 필요는 없습니다(물론 그러지 않았겠지만). 하지만 되도록 가가운 위치에 두는 것이 좋습니다. 예를 들어, 제 경우에는 htdocs 폴더가 웹 루트입니다. 아래의 그림이 제 폴더 구조입니다.

My directory structure.

팁: 만약 여러개의 사이트를 한 서버에서 Yii 를 이용해 운영하고 싶다면, framework 폴더를 상대적으로 접근하기 쉬운 위치에 두는 것이 좋습니다. 이렇게 하면 프레임워크를 업데이트할 때 한 곳의 파일들만 변경하면 되기 때문입니다.

그리고 나면 명령어 기반의 환경으로 들어가야 합니다. 예컨데 DOS창이나 윈도우 콘솔, 혹은 Mac OS X(혹은 몇몇 버전의 리눅스)의 터미널 어플리케이션 같은 것들입니다. 그 후 framework 디렉토리로 이동합시다. 제 서버의 경우에는 아래의 명령어를 통해 이동할 수 있습니다.

cd /Users/larryullman/Sites/YiiBlogSite/framework

각 부분을 각자의 환경에 맞게 수정해서 실행하세요.

그 다음 단계는 framework 폴더 내에 있는 yiic 프로그램에게 새로운 사이트를 만들도록 지시하는 것입니다. 문법은 아래와 같습니다.

yiic webapp path/to/directory

이 명령어를 사용하기 전에 잠깐 중요하고 복잡한 내용을 좀 설명 하도록 하죠. yiic 파일은 컴퓨터의 PHP 명령줄 도구를 통해 실행되며 실제로는 yiic.php 스크립트를 실행하도록 합니다. 단순히 yiic 혹은 ./yiic (현재 디렉토리의 yiic 파일을 실행하는 명령)을 통해 사용이 가능합니다. 혹은 좀 더 명시적인 방법으로는 php yiic 나 php yiic.php 같은 명령을 통해 yiic.php 스크립트를 실행할 수도 잇습니다. 그 외에도 PHP 의 위치를 명확히 표시하기 위해 c:\php\php.exe yiic 같은 명령을 사용할 수도 있습니다. 웹 어플리케이션을 작성하기 전에 여러가지 방식으로 자신의 컴퓨터상에서 작동되는 명령어를 찾아두는 것이 좋습니다.

혹시 컴퓨터에 여러개의 PHP 버전이 설치되어 있다면, yiic 를 제대로 실행하기 위해서 해야 할 일이 또 생겨납니다. PHP 버전을 확인하려면 콘솔에서 php -v 명령을 실행하세요(다시 말하지만, php 실행파일의 전체 경로를 써야 할 수도 있습니다). Mac OS X 나 유닉스라면, which php 명령을 사용해서 단순히 php 라고 썼을 때 어떤 실행파일을 실행하는지를 알아볼 수 있습니다. 혼란스러운 문제들을 해결하는 데에 이러한 단계들을 거치는 게 도움이 될 수 있습니다. 예를 들어 저는 Mac 에서 PHP 와 MySQL 을 사용하기 위해 MAMP Pro 를 이용합니다. 하지만 제가 콘솔에서 php 명령을 실행할 때에는 실제로는 OS 와 함께 설치된 PHP 실행파일을 부르게 되죠. 이런 경우에는 문제가 생길 수 있습니다. OS 와 함께 설치된 PHP 의 버전과 MAMP Pro 와 함께 설치된 버전이 다르다면, 첫번째 포스트에서 거쳤던 Yii 실행 가능 환경 검사를 제대로 받았다고 할 수 없기 때문입니다. 처음 이 문제를 알게 된 건 콘솔에서 사용하는 PHP(OS와 함께 설치된 PHP)가 PDO 확장을 지원하지 않았기 때문입니다. 웹에서 사용되는 PHP(MAMP Pro 와 함께 설치된 버전)는 지원하고 있었는데 말이죠. 제 경우에는 MAMP Pro 에서 사용되는 PHP 의 실행파일 경로를 명시적으로 적어줌으로써 해결했습니다.
예를 들면 /Applications/MAMP/bin/php5.3/bin/php yiic 처럼요.

yiic 를 실행하기 위한 적절한 명령어를 알아냈으면, 이제 새로운 웹 어플리케이션을 만들기 위한 명령어를 따라할 준비가 된 겁니다. 아래 명령어의 경로 부분을 웹 어플리케이션의 경로로 바꾸어서 실행해 주세요. 아까 보여드린 디렉토리 구조와 같은 경우, 명령어는 아마도 아래와 같을 겁니다.

./yiic webapp ../htdocs

혹은,

php yiic webapp ../htdocs

아니면 적당히 자신의 환경에 맞는 명령어를 사용해도 괜찮습니다.

지정한 디렉토리에 새로운 웹 어플리케이션을 작성할 것인지 묻는 질문이 나오게 됩니다. Y 나 Yes 를 치고 엔터 키를 눌러주세요. 이것저것 많이 출력되고 난 뒤에, 어플리케이션이 성공적으로 생성되었다는 메시지가 나올 것입니다. 생성된 어플리케이션을 확인하려면 브라우저로 사이트를 열어보면 됩니다. (물론 URL 을 브라우저에 넣어야겠죠)

자동으로 생성된 기본 Yii 어플리케이션

기능적인 측면에서, 생성된 어플리케이션은 아래와 같은 것들을 포함하고 있습니다.

자세한 도움말이 있는 홈페이지
CAPTCHA 가 적용된 의견 보내기 페이지
로그인 폼
로그인 한 사용자의 이름에 따라 환영 메시지를 보여주는 기능
로그아웃 기능

아직 한 줄의 코드도 쓰지 않은 데 비해서 정말 괜찮은 어플리케이션이 만들어졌습니다. 좋은 시작이죠. 의견 보내기 폼은 여러분이 수정한 설정의 이메일 주소로만 작동됩니다. 로그인하려면 아이디와 패스워드를 demo/demo 혹은 admin/admin 으로 넣으면 됩니다. 마지막으로, 만들어진 사이트의 모양은 yii 프레임워크의 버전에 따라 다를 수 있습니다.

서버의 어플리케이션이 있는 디렉토리(제 경우에는 htdocs) 내에서는 아래와 같은 파일/디렉토리 목록을 볼 수 있습니다.

assets
css
images
index-test.php
index.php
protected
themes

assets 폴더는 주로 jQuery(자바스크립트 프레임워크)와의 통합에 사용됩니다. css 폴더와 images 폴더는 설명 안 해도 아시겠죠. 전체 사이트는 두 개의 index 파일 중 하나를 통해 실행됩니다. (다음 포스트에 좀 더 자세히 설명하겠습니다.) protected 폴더는 실제로 가장 중요한 폴더입니다. 이 폴더 내의 파일을 수정해서 사이트의 모양이나 기능을 수정할 수 있습니다. 그리고 themes 폴더는 워드프레스 블로그에서 보이는 것처럼 사이트의 여러가지 템플릿을 만들 수 있게 해줍니다.

팁: asserts 폴더는 웹서버가 쓸 수 있도록 권한이 설정되어있어야 합니다. 그렇지 않으면 오류가 나타날 수 있습니다. 사실 이 부분은 Yii 로 만든 사이트를 한 서버에서 다른 서버로 옮기는 경우에, 옮겨진 폴더가 제대로 된 권한을 갖지 않도록만 신경쓰시면 됩니다.

자, 이제 Yii 기반의 웹 어플리케이션 제작을 시작해 보았습니다. Yii 를 이용해 어떤 사이트를 만들게 되더라도 이러한 단계를 비슷하게 이용하시면 됩니다. 다음 게시물에서는 어떻게 어플리케이션의 설정을 수정하는지를 설명하고, 예제로 쓰일 직원 관리 프로그램에 알맞게 고쳐보겠습니다.

제 글에 흥미를 가져주셔서 늘 감사합니다. 질문이나 하고 싶은 말이 있으시면 언제든지 제게 알려주세요(원 저자 Larry 의 말입니다 - 역자 주).

Larry

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.

이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

jQuery 만화책 뷰어 플러그인.

LazyGyu — Wed, 08 Feb 2012 23:11:22 +0900

만화책을 간단히 보여주고 싶을 때 사용할만한 플러그인.

플러그인 다운로드 :

jquery.toonviewer.js

예제 페이지 : http://l.monoless.com/toonviewer

소스보기 해보면 알겠지만 만화책 뷰어로 사용할 div 객체에 .toonviewer 함수를 이용하는 방식.

사용 가능한 매개변수 목록

변수명	기본값	역할
url	-	이미지 파일들이 들어있는 경로를 입력한다.
leftToRight	True	왼쪽에서 오른쪽으로 보는 만화책인지 설정.
width	1000px	만화책뷰어의 가로 크기
height	800px	만화책뷰어의 세로 크기
file_prefix	-	파일명 앞부분.
file_suffix	.jpg	파일명 뒷부분.
digitCount	2	페이지를 나타내는 숫자의 자리수
startPage	0	시작 페이지
endPage	1	마지막 페이지

메소드

메소드명	매개변수	사용법
go	페이지 번호	.toonviewer("go", 10)
getPage	-	.toonviewer("getPage")

Learning the Yii Framework 1 / 8

LazyGyu — Fri, 20 Jan 2012 12:27:23 +0900

이 문서의 원본은 http://www.larryullman.com/2009/06/18/introduction-to-the-yii-framework/ 입니다. Yii 프레임워크를 초심자가 차근차근 따라가기에 좋은 시리즈인 것 같아 번역하게 되었습니다. - LazyGyu

Yii Framework 소개

이 문서는 Yii 프레임워크 배우기 시리즈의 8 편 중 첫번째 문서입니다.

2009년, 저(저자인 Larry Ullman을 말함 - 역자 주)는 세 개의 꽤 규모있는 사이트를 개발했습니다. 그래서 저는 처음부터 모든 걸 개발하는 것 대신에 PHP 프레임워크를 사용해야겠다고 생각했습니다. 이전까지 루비 온 레일즈를 웹 개발에 사용했었기 때문에 프레임워크나 MVC 구조에는 익숙한 상태였지만 PHP 프레임워크를 배워보고 싶었습니다. 몇 개의 프레임워크를 연구해보고, Zend 프레임워크를 사용하려 시도했다가 실망한 후에, 결국 저는 Yii 프레임워크에 도달하게 되었습니다. 그 당시에 Yii 프레임워크는 아직 새로운 물건이었고, 여전히 고쳐져야 할 버그들이 있었습니다(나중에 좀 더 전문적인 글에서 다루겠습니다). 하지만 Yii 는 사용하기 쉬운데다가 동작도 잘 되었습니다. 이 글에서는 일단 Yii 를 설치하고 테스트하는 방법에 대해서만 논의하도록 하겠습니다.

(2010년 10월, 저는 이 글이 씌어진 이후 Yii 의 업데이트를 반영하고 코멘트를 통해 제공된 피드백을 고려하여 문서를 수정하였습니다. 더이상 맞지 않는 내용들은 수정되었지만, 시리즈가 2009년 6월에 시작된 이후 어떻게 변화했는지를 알 수 있도록 남겨두었습니다.)

Yii 프레임워크를 사용하기 위해 가장 먼저 해야 할 일은 물론 PHP 가 설치된 웹 서버에 접근하는 것입니다. 하지만 이 글을 읽고 있는 사람이라면 일단 PHP 가 활성화된 서버에 이미 접근할 수 있는 사람이라고 가정하겠습니다. 참고로 Yii 프레임워크는 PHP 5.1 이나 그 이상의 버전을 필요로 합니다. 다행히 Yii 는 서버의 설정을 테스트해줍니다. Yii 의 최신 안정화 버전을 다운로드 합시다. 이 글을 쓰는 시점에서 최신 버전은 ~~1.0.6~~ 1.1.4 입니다. 다운로드 한 파일의 이름은 아마 yii-버전.release.ext 와 같은 형태일 겁니다. 용량은 2MB 정도일거구요. 다운받은 파일의 압축을 풀면 다음과 같은 것들이 들어 있습니다.

CHANGELOG, LICENSE, README, UPGRADE 문서들
demos 폴더
framework 폴더
requirements 폴더

물론 README 와 LICENSE 를 읽어야하지만, 일단 여기서는 폴더들이 더 중요합니다. demos 폴더는 Yii 를 사용해 만들어진 네 개의 웹 어플리케이션을 담고 있습니다. 블로그, 행맨 게임, 기본적인 "Hello, World!", 전화번호부 등입니다. 데모들은 코드가 어떻게 이루어져있는지, 그리고 어떻게 코드를 작성해야 하는지를 잘 보여줍니다. framework 폴더는 Yii 를 사용하는 웹 사이트에 필수적으로 필요한 폴더입니다. requirements 폴더는 뭔가 단순하고 빛나는 것들이...

마찬가지로 이 글을 보는 사람이라면 자신의 컴퓨터, 혹은 서버의 웹 루트가 어디인지 알고 있을거라 가정하겠습니다. 웹 루트란 URL 이 가리키는 곳을 나타내는 폴더입니다. 다시말해, http://localhost 나 http://www.example.com 등을 브라우저로 열었을 때 브라우저는 웹 루트 폴더에 있는 문서를 보여줍니다. Yii 의 정책에 따라 이 폴더를 웹루트라 부르도록 하겠습니다. 웹루트에 yii 폴더를 만들고 framework 와 requirements 폴더를 거기에 복사합시다. 그리고 나서 yourURL/yii/requirements 를 웹 브라우저로 열어봅시다. (예 : http://localhost/yii/requirements) 그러면 최소 요구사항에 적합한지 아닌지를 나타내는 보고서를 볼 수 있습니다.

모든 요구사항이 충족되었다면 사용할 준비가 된 것입니다. 참고로 모든 확장이 반드시 필요한 것은 아닙니다. 단순히 Yii 프레임워크 요구사항, PDO, 사용하는 데이터베이스에 맞는 PDO 확장만 있으면 됩니다. (잘 모르시는 분을 위해 말씀드리자면, PDO 는 데이터베이스 추상화 계층입니다. 웹사이트를 데이터베이스와 분리할 수 있도록 해줍니다.)

다음 게시물에서는 Yii 명령줄 도구를 사용해서 어떻게 첫 웹 어플리케이션을 만드는 지 보여드리겠습니다. 굉장히 쉽고 제가 본 것들 중에 루비 온 레일즈와 가장 비슷합니다. 후속 게시물들은 Yii 기반 어플리케이션을 개발하는 방법을 다루고 있습니다. 최 상단이나 하단의 링크를 사용해서 시리즈를 탐색할 수 있습니다.(여긴 없어요 - 역자 주). 혹시 관심이 있으시다면 MVC 구조에 관한 저의 포스트도 읽어보세요.

This is a translation of a work originally written in English by Larry Ullman (www.LarryUllman.com). It is translated and republished with his permission.
이 글은 영어로 작성된 Larry Ullman 의 원본 글을 번역한 것입니다 ( http://www.LarryUllman.com ). 이 글은 저자의 허락을 받아 번역되었습니다.

NowJS 시작하기

LazyGyu — Sun, 08 Jan 2012 00:57:55 +0900

아래는 node.js 의 모듈 중 하나인 nowjs 의 초보자 가이드를 번역한 내용입니다. 원문은 http://nowjs.com/guide 에서 보실 수 있습니다. node.js 는 갈수록 하나의 완성된 체계를 구축해가는 것 같아요. 아직은 입지가 크지 않지만 향후가 점점 기대되는 플랫폼입니다. 다들 즐겁게 코딩하세요! -Lazygyu

NowJS 를 시작하는 것은 정말 쉽습니다. 여기서 우리는 간단한 채팅 서버를 약간의 코드만으로 만들어보겠습니다. 당신의 컴퓨터에서 따라해보려면 두 소스 파일을 다운로드 할 수 있습니다. 여기를 클릭하세요.

마술 주머니

NowJS 의 비밀은 두 개의 마술 주머니에서 비롯됩니다. 바로 now 와 everyone.now 입니다. now 객체는 클라이언트와 서버 사이에서 공유되는 마술 주머니입니다. 클라이언트는 now 객체에 변수와 함수들을 자유롭게 넣을 수 있고, 서버 또한 자유롭게 그것들에 접근할 수 있습니다. 물론 반대로도 가능합니다.

서버는 한 번에 수많은 클라이언트 연결을 가질 수 있습니다. 이는 바꿔 말하면 한 번에 수많은 마술주머니를 관리해야 한다는 뜻입니다. 그것이 바로 everyone.now 라는 또다른 마술 주머니를 서버가 가지고 있는 이유입니다. 서버가 everyone.now 에 어떤 변수를 추가하거나 변경하게 되면 모든 클라이언트 각각의 now 가 함께 변경됩니다.

채팅 서버 구축

TL;DR

이 게시물은 아마 좀 긴 글이 될 겁니다. 하지만 채팅 서버를 구축하는 과정 자체는 아주 간단합니다. 클라이언트는 서버의 distributeMessage 함수를 보내고 싶은 메시지와 함께 호출합니다. distributeMessage 함수는 모든 클라이언트의 recieveMessage 함수를 호출합니다. recieveMessage 함수는 메시지를 받아 화면에 뿌려주는 함수입니다.

서버에서

우리가 만들 채팅 프로그램에서, 클라이언트는 서버를 통해 모든 클라이언트로 메시지를 전달할 수 있어야 합니다. 우리는 이 함수를 distributeMessage 라고 명명하겠습니다. 이 함수는 서버에서 실행되어야 하므로, 서버의 .js 파일에 넣도록 하겠습니다.

everyone.now.distributeMessage = function(message){
everyone.now.recieveMessage(this.now.name, message);
}

함수 내부에서 어떤 일이 일어나는지는 신경쓰지 마세요. 중요한것은 우리가 저 함수를 everyone.now 에 추가했다는 겁니다. 이것은 모든 연결된 클라이언트와, 앞으로 연결될 클라이언트가 각자의 now 를 통해 distributeMessage 함수를 사용할 수 있다는 것을 의미합니다.

위의 코드를 넣고나면, 클라이언트는 now.distributeMessage 함수를 호출할 수 있고, 그러면 서버는 위의 코드를 실행하게 됩니다.

클라이언트에서

잠시 클라이언트측 코드를 봅시다. 일단 각 사용자들이 자신의 이름을 설정할 수 있게 해야 합니다. 아래에 이름을 설정하게 하는 짧은 코드가 있습니다.

now.name = prompt("이름이 뭥미?", "");

now 객체에 name 이라는 변수를 추가해서 여기에 이름을 보관했다는 것을 잘 보십시오. 이것은 이 클라이언트가 서버에 메시지를 보낼 때, 서버측에서 이 클라이언트의 name 을 읽고 사용할 수 있다는 것을 의미합니다.

멋지긴 한데, 그럼 어떻게 메시지를 보낼까요? 여기 방법이 있습니다.

$("#send-button").click(function(){
now.distributeMessage($("#text-input").val());
$("#text-input").val("");
});

서버에서 distributeMessage 함수를 모든 클라이언트의 now 에 넣었다는 것을 기억하시겠죠? 사용자가 전송 버튼을 클릭하게 되면, distributeMessage 함수에 메시지를 매개변수로 호출하게 됩니다. 서버는 호출을 받고, 함수를 실행하고, 모든 사용자는 방금 보낸 메시지를 받게 되겠죠. 어떻게 이렇게 되는지 살펴봅시다.

다시 서버로

자, 클라이언트는 그저 distributeMessage 를 호출했습니다. 서버는 각각의 클라이언트의 "문맥(Context)"에 맞추어 이 함수를 실행하죠. 이것은 서버의 함수 내용이 클라이언트측 now 의 모든 것에 접근할 수 있다는 의미입니다. 우리는 this.now 를 통해 클라이언트의 now 객체의 모든 속성에 접근할 수 있습니다.

이 경우에, 우리는 다른 모든 클라이언트들이 지금 메시지를 보낸 사용자의 이름을 알게 하고 싶습니다. 함수를 호출한 클라이언트의 이름은 this.now.name 을 참조하면 알 수가 있죠. 혹시 잊지 않았을까 해서 다시 한 번 코드를 보여드립니다.

everyone.now.distributeMessage = function(message){
everyone.now.recieveMessage(this.now.name, message);
}

모든 클라이언트의 recieveMessage 함수에 메시지 내용과 함께 사용자 이름을 보내고 있군요. 잠깐, reciveMessage? 이건 어디서 온 걸까요? 이제 보여드리겠습니다.

다시 클라이언트로(진짜 마지막이에요)

recieveMessage 함수는 클라이언트 코드에 있습니다. 아래 코드를 참조하세요.

now.recieveMessage = function(name, message){
$("#messages").append("<br>" + name + ": " + message);
}

클라이언트는 recieveMessage 함수를 now 내에 넣었습니다. 따라서 서버는 새로운 메시지가 있을 때 해당 함수를 호출할 수 있죠. 해당 함수가 하는 일은 그저 새로운 메시지를 페이지에 추가하는 것 뿐입니다.

클라이언트측에서 recieveMessage 함수를 now 에 넣었기 때문에, 서버의 everyone.now 에서도 마찬가지로 추가되었습니다. 이렇게 하면 서버에서는 쉽게 모든 클라이언트의 recieveMessage 함수를 한 번에 호출할 수 있습니다. 그리고 이게 바로 서버가 distributeMessage 함수 내에서 하는 일이죠.

마무리

NowJS 를 통해 무언가를 만드는 데 필요한 것은 이게 전부입니다. 당신은 이 지식을 통해 어떠한 실시간 어플리케이션도 쉽고 빠르게 구축할 수 있습니다. 즐거운 코딩 되세요!

더 읽어보기

이제 당신은 초보자 안내서를 읽었습니다. 이제 NowJS 의 사용자 설명서와 좋은 사례 모음을 읽어보세요.

궁금한 점이 있나요? Freenode 에서 #nowjs 를 찾으세요.

요즘 틈틈히 개발중인 안드로이드용 게임 동영상

LazyGyu — Mon, 19 Sep 2011 02:23:48 +0900

온라인 대전 기능이 있는 사천성이라능

근데 블로그 할 시간이 너무 없다 ㅠㅠ

奎 :: 닿지 않아도 볼 수 있다면

Javascript 에서 cp949 를 유니코드 문자열로 변환하기

Learning the Yii Framework 6 / 8

Yii 기본 모델 편집하기

Learning the Yii Framework 5 / 8

Yii 에서 모델, 뷰, 컨트롤러 만들기

Learning the Yii Framework 4 / 8

Yii 어플리케이션용 데이터베이스 정의하기

Learning the Yii Framework 3 / 8

Yii 설정하기

Learning the Yii Framework 2 / 8

Yii 프레임워크 시작하기

jQuery 만화책 뷰어 플러그인.

Learning the Yii Framework 1 / 8

이 문서의 원본은 http://www.larryullman.com/2009/06/18/introduction-to-the-yii-framework/ 입니다. Yii 프레임워크를 초심자가 차근차근 따라가기에 좋은 시리즈인 것 같아 번역하게 되었습니다. - LazyGyu Yii Framework 소개

NowJS 시작하기

요즘 틈틈히 개발중인 안드로이드용 게임 동영상

이 문서의 원본은 http://www.larryullman.com/2009/06/18/introduction-to-the-yii-framework/ 입니다. Yii 프레임워크를 초심자가 차근차근 따라가기에 좋은 시리즈인 것 같아 번역하게 되었습니다. - LazyGyu

Yii Framework 소개