프로그래밍이야기

모듈만들기 .. 2

haneul — Fri, 26 Sep 2008 15:12:28 +0900

오늘은 모듈 안의 각파일들의 역할에 대해서 이야기를 좀 해보겠습니다
modules/모듈명/ 디렉토리에 들어가보면 우선 php파일들을 발견하실 수 있습니다.

우선 기본 class파일이 있습니다.
모듈명.class.php : 해당 모듈의 기본이 되는 클래스. ModuleObject를 상속하고 있다. 모듈의 다른 클래스들은 이 기본 클래스를 상속 받아서 구현한다. 모듈이 인스톨될 때, 업데이트 될 때, 캐시 재생성할 때의 해야할 동작들을 정의하는 함수들을 포함한다.

그 외는 이제 MVC모델에서와 같이 Model, View, Controller에 해당하는 클래스들이 있는데요.
zeroboardXE 에서는 전통적인 MVC를 그대로 따르고 있다고는 이야기하기 힘들지만, 대략적으로 model이 데이터를 다루는 작업(주로 디비에서 데이터를 가져오는 함수들), controller에서는 데이터를 집어넣는 부분(디비에 insert나 update를 하는 작업), view에서는 사용자에게 보여지는 화면을 구성하기 위해 model에서 data를 가져와서 template을 compile하는 작업을 맡고 있습니다.

모듈명.admin.view.php 등, 중간에 admin이 들어간 녀석들은 관리자 화면과 주로 관련이 되어있는 클래스들입니다. 관리자 화면 뷰를 만들어주거나, 관리자가 할 수 있는 control에 대한 정의를 하고 있습니다.

우선 모듈이 만들어지기 위해 필요한 파일들은
모듈명.class.php : moduleInstall, checkUpdate함수를 구현해주어야 합니다.
기본적인 데이터를 포함하고 있는 conf/info.xml 입니다.

그럼 test라는 간단한 모듈을 통해 모듈이 생성되는 것 까지를 일단 보여드리겠습니다.

modules/test디렉토리 아래 test.class.php와 conf/info.xml을 다음과 같이 만들어보았습니다.

test.class.php

<?php
    class test extends ModuleObject
    {
        function moduleInstall()
        {
            return new Object();
        }

        function checkUpdate()
        {
            return false;
        }
    }
?>

conf/info.xml

<?xml version="1.0" encoding="UTF-8"?>
<module version="0.2">
    <title xml:lang="ko">test 모듈</title>
    <description xml:lang="ko">test 모듈입니다.</description>
    <version>0.1</version>
    <date>2008-09-25</date>
    <category>base</category>
    <link>http://www.zeroboard.com</link>
    <author email_address="haneul@zeroboard.com" link="http://www.seungyeop.kr">
        <name xml:lang="ko">haneul</name>
    </author>
</module>

이렇게 하고 나면, admin 페이지의 모듈란에서 test 모듈을 찾을 수 있습니다.

이제 다음강좌에서는 실제 디비를 만들고 연동하는 부분을 이야기해보도록 하겠습니다.

모듈 만들기 .. 1

haneul — Tue, 16 Sep 2008 17:20:46 +0900

간만의 글 하나입니다.

모듈은 zbXE의 기본이 되는 프로그램입니다.
지금 보고 있는 게시판(블로그)이나, BNU님이 만드신 Planner, 혹은 이슈트래커 등이 하나의 모듈로 되어있습니다.
또한, RSS나, 댓글, 문서등의 관리도 모듈이라는 단위로 동작하고 있습니다.

기본 모듈들에서 스킨 변경 이상의 기능들 (추가 Database가 많이 필요하다던가)을 지원하고 싶으시면 결국 모듈을 만들어야 합니다.

모듈들은 ./modules directory아래에 모여있습니다.

board, file, point등이 보이는군요 +_+

예제로 쓸 bookmark 모듈 안을 들여다 보면 아래와 같이 구조가 있습니다.

조금더 복잡한 document를 봅시다-

각 파일들은 어떤 역할들을 하고 있는지를 우선 살펴보면,
우선 디렉토리들은

conf : 설정 파일들을 포함하고 있습니다. (info.xml, module.xml)
lang : 언어 파일들을 포함하고 있습니다. (ko.lang.php, jp.lang.php ... )
queries : 쿼리 파일들을 포함하고 있습니다. (insertDocument.xml ... )
schemas : 데이터베이스 스키마 파일들을 포함하고 있습니다. ( documents.xml ... )
tpl : 스킨으로 설정하지 않는 template파일들을 포함하고 있습니다.
skins : 스킨 디렉토리들을 포함하고 있습니다.

파일들에는,

.class.php를 기본으로 해서,
.controller.php, .view.php, .model.php 가 기본 동작들을
.admin. 파일들이 admin모드에서의 동작들을 정의하고 있습니다.
controller, view, model이 각각 무슨 역할을 하는 지는 다음편에 --a
하겠습니다 @_@

1. debugPrint?

haneul — Mon, 08 Sep 2008 12:33:27 +0900

전부터 시도만 해보려던 강좌를 좀 써보려고 합니다. -_ -a

오픈소스프로젝트 모임 1회때 발표했던 내용부터 시작해서, 실제 zbXE로 여러 프로그램을 개발하는데 필요한 정보들을 전달 드리는데 목적이 있습니다.

질문은,... 음 댓글이나 제로보드 공식 홈페이지에 쓰시는 것이 좋겠지요? :)

첫글은 debugPrint로 시작합니다.
C++ 개발을 해보신 분이라면 정상 동작을 확인하기 위해서, 혹은 안되는 부분을 고치기 위해서 printf로 여기저기 코드를 끼워놓으신 경험이 있을 거에요.
특히나 PHP는 한줄씩 실행을 하기 때문에 특정 위치까지만 실행이 되는 경우가 있습니다. 그럼 도대체 어디까지 실행이 되었는지를 체크해볼 필요도 있습니다.

zbXE에서는 이러한 동작들을 쉽게 처리하기 위해서 debugPrint라는 함수를 제공하고 있습니다.
config/func.inc.php에 정의되어있는 debugPrint함수는 argument로 넘겨준 값과 함께 어느 파일 몇번째 줄에서 불렸는지, 언제 불렸는지(r4483에서 추가)를 보여주게 됩니다.

예를 들어, board.view.php의 154번째 줄에
debugPrint($document_srl);
라는 명령을 추가하고,

http://seungyeop.kr/20790 에 접근해보았습니다.
그러면 이제 ./files/_debug_messages.php라는 파일에 다음과 같이 기록이 됩니다.

Query의 output등을 확인할 때 유용하게 쓸 수 있습니다. :)

다음 강좌에서는; 실제 모듈을 만들어 보겠습니다-