dhtmlxScheduler와 PHP:Slim
이 튜토리얼은 Slim 4 프레임워크와 서버 측의 REST API를 결합하여 PHP 기반 Scheduler를 구축하는 필수 단계를 제공합니다.
이 튜토리얼은 Slim Framework v4.x를 사용합니다. 이전 버전을 사용 중이라면 Slim Framework v3.x 가이드를 참고하세요.
다른 플랫폼 및 프레임워크와의 통합을 위한 추가 튜토리얼도 제공됩니다:
- "dhtmlxScheduler와 ASP.NET Core"
- "dhtmlxScheduler와 ASP.NET MVC"
- "dhtmlxScheduler와 Node.js"
- "dhtmlxScheduler와 PHP"
- "dhtmlxScheduler와 PHP:Laravel 연동하기"
- "dhtmlxScheduler와 SalesForce LWC 통합하기"
- "dhtmlxScheduler와 Ruby on Rails 연동하기"
- "dhtmlxScheduler와 dhtmlxConnector 연동하기"
PHP 애플리케이션을 개발할 때는 처음부터 모든 것을 직접 구축하기보다는 기존 프레임워크를 사용하는 것이 일반적입니다.
이 가이드에서는 Slim 4 프레임워크와 서버 측 REST API를 함께 사용하며, 데이터 저장소로는 MySQL을 사용합니다. CRUD 연산은 PDO를 통해 처리되며, 다른 프레임워크와 함께 사용할 수 있을 만큼 유연하게 설계되어 있습니다.
완성된 데모가 GitHub에 준비되어 있습니다. 아래 단계를 따라 유사한 애플리케이션을 만들어보세요.
전체 소스 코드는 GitHub에서 확인할 수 있습니다.
1단계. 프로젝트 초기화
프로젝트 생성
시작점은 Slim 4 프레임워크용 스켈레톤 애플리케이션을 사용하는 것입니다.
Composer를 이용해 애플리케이션을 생성합니다:
$ composer create-project slim/slim-skeleton scheduler-slim-howto
$ cd scheduler-slim-howto/
2단계. 페이지에 Scheduler 추가
다음 단계는 웹 페이지에 스케줄러를 배치하는 것으로, 두 가지 간단한 하위 단계로 구성됩니다.
뷰 생성
app/templates 디렉터리 내에 basic.html 파일을 생성합니다:
<!doctype html>
<html>
<head>
<title> Getting started with dhtmlxScheduler</title>
<meta charSet="utf-8"/>
<script src="https://cdn.dhtmlx.com/scheduler/edge/dhtmlxscheduler.js"></script>
<link href="https://cdn.dhtmlx.com/scheduler/edge/dhtmlxscheduler.css"
rel="stylesheet" type="text/css" charSet="utf-8">
<style>
html, body{
margin:0px;
padding:0px;
height:100%;
overflow:hidden;
}
</style>
</head>
<body>
<div id="scheduler_here" className="dhx_cal_container">
<div className="dhx_cal_navline">
<div className="dhx_cal_prev_button"> </div>
<div className="dhx_cal_next_button"> </div>
<div className="dhx_cal_today_button"></div>
<div className="dhx_cal_date"></div>
<div className="dhx_cal_tab" name="day_tab"></div>
<div className="dhx_cal_tab" name="week_tab"></div>
<div className="dhx_cal_tab" name="month_tab"></div>
</div>
<div className="dhx_cal_header"></div>
<div className="dhx_cal_data"></div>
</div>
<script>
scheduler.config.xml_date="%Y-%m-%d %H:%i";
scheduler.init('scheduler_here', new Date(2019,0,20), "week");
scheduler.load("/events");
var dp = scheduler.createDataProcessor("/events");
dp.init(scheduler);
dp.setTransactionMode("REST"); // use to transfer data with REST
</script>
</body>
</html>
라우트 설정
새로운 페이지가 준비되면, 브라우저에서 접근할 수 있도록 라우트를 추가해야 합니다. app/routes.php에 다음을 추가하세요:
$app->get('/', function (Request $request, Response $response) {
$payload = file_get_contents('../app/templates/basic.html');
$response->getBody()->write($payload);
return $response;
});
이제 앱을 실행하면 페이지에 스케줄러가 표시됩니다:

3단계. 데이터베이스 준비
스케줄러가 준비되었으니, 다음 단계는 데이터베이스를 설정하고 애플리케이션과 연결하는 것입니다.
데이터베이스 생성
데이터베이스는 선호하는 MySQL 클라이언트(예: phpMyAdmin) 또는 커맨드라인을 통해 생성할 수 있습니다. 아래는 캘린더 이벤트용 데이터베이스와 테이블을 생성하는 SQL 예시입니다:
CREATE DATABASE IF NOT EXISTS `scheduler`;
USE `scheduler`;
DROP TABLE IF EXISTS `events`;
CREATE TABLE `events` (
`id` int(11) AUTO_INCREMENT,
`start_date` datetime NOT NULL,
`end_date` datetime NOT NULL,
`text` varchar(255) DEFAULT NULL,
PRIMARY KEY (`id`)
) DEFAULT CHARSET="utf8;"
MySQL 콘솔을 통해 가져오려면, 위 SQL을 dump.sql 파일로 저장한 후 다음 명령을 실행하세요:
$ mysql -uuser -ppass scheduler < mysql_dump.sql
다음으로, app/settings.php를 열고 데이터베이스 설정 배열을 추가한 후 본인 환경에 맞게 수정하세요:
'pdo' => [
'engine' => 'mysql',
'host' => 'localhost',
'database' => 'scheduler',
'username' => 'user',
'password' => 'pass',
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'options' => [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => true,
],
]
이후, app/dependencies.php를 수정하여 PDO 인스턴스를 애플리케이션 컨테이너에 주입하세요:
// Inject a new instance of PDO into the container
$containerBuilder->addDefinitions([
PDO::class => function (ContainerInterface $container) {
$config = $container->get('settings')['pdo'];
$dsn = "{$config['engine']}:host="{$config["'host']};dbname="{$config["'database']};
charSet="{$config["'charset']}";
$username = $config['username'];
$password = $config['password'];
return new PDO($dsn, $username, $password, $config['options']);
},
]);
4단계. 데이터 불러오기
스케줄러는 이미 "/events" 엔드포인트에서 이벤트 데이터를 요청하도록 설정되어 있습니다. 이제 이 라우트에 실제 데이터를 제공하는 핸들러를 추가할 차례입니다.
스케줄러에는 여러 핸들러가 필요하므로, Slim 4의 route groups를 사용해 이를 정리합니다.
app/routes.php를 열고 "/events" 그룹과 GET 액션을 추가하세요:
$app->group('/events', function ($group) {
$group->get('', function (Request $request, Response $response, array $args) {
$db = $this->get('PDO');
$queryText = 'SELECT * FROM `events`';
$params = $request->getQueryParams();
$query = $db->prepare($queryText);
$query->execute();
$result = $query->fetchAll();
$payload = json_encode($result);
$response->getBody()->write($payload);
return $response->withHeader('Content-Type', 'application/json');
});
});
이벤트가 데이터베이스에 추가되면, 스케줄러에서 확인할 수 있습니다.
동적 로딩
이 단계에서는 스케줄러가 시작 시 모든 이벤트 레코드를 불러옵니다. 이 방식은 데이터셋이 적을 때는 괜찮지만, 오래된 기록을 삭제하지 않고 계획이나 예약 용도로 사용할 경우 데이터가 점점 많아질 수 있습니다. 시간이 지나면 사용자가 페이지를 불러올 때마다 대량의 데이터를 요청하게 될 수 있습니다.
동적 로딩을 사용하면, 스케줄러가 현재 표시 중인 날짜 범위를 요청 파라미터로 전송하여, 서버는 관련 레코드만 반환합니다. 사용자가 보이는 날짜 범위를 바꿀 때마다 스케줄러는 새로운 데이터 하위 집합을 받아옵니다.
클라이언트 측에서 동적 로딩을 활성화하려면, setLoadMode 메서드에 "day", "week" 또는 "month" 중 하나의 값을 사용하세요. 예시:
scheduler.config.xml_date="%Y-%m-%d %H:%i";
scheduler.init("scheduler_here", new Date(2019, 0, 20), "week");
scheduler.setLoadMode("day");
scheduler.load("/events");
서버 측에서는 다음과 같이 처리할 수 있습니다:
$app->group('/events', function ($group) {
$group->get('', function (Request $request, Response $response, array $args) {
$db = $this->get('PDO');
$queryText = 'SELECT * FROM `events`';
$params = $request->getQueryParams(); /*!*/
$queryParams = []; /*!*/
if (isset($params['from']) && isset($params['to'])) { /*!*/
$queryText .= " WHERE `end_date`>=? AND `start_date` < ?;"; /*!*/
$queryParams = [$params['from'], $params['to']]; /*!*/
} /*!*/
$query = $db->prepare($queryText);
$query->execute($queryParams); /*!*/
$result = $query->fetchAll();
$payload = json_encode($result);
$response->getBody()->write($payload);
return $response->withHeader('Content-Type', 'application/json');
});
});
5단계. 변경사항 저장
백엔드 핸들러 구현하기
이 시점에서 스케줄러는 백엔드에서 데이터를 가져올 수 있습니다. 다음 단계는 변경 사항을 데이터베이스에 저장할 수 있도록 하는 것입니다.
클라이언트 측은 REST 모드로 동작하므로 이벤트를 관리하기 위해 POST, PUT, DELETE 요청을 보냅니다. 스케줄러에서 사용하는 요청 형식과 모든 라우트에 대해 참고하세요.
이를 위해, 데이터 모델에서 동작을 처리하는 컨트롤러를 정의하고, 해당 라우트를 설정하며, 클라이언트 측에서 데이터 저장 기능을 활성화해야 합니다.
app/routes.php