2021.11.19

CakePHP4でのGoogle API連携後編
〜CakePHP4でのスケジュール操作〜

こんにちは、マイロプスでエンジニアをしているFukushimaです。
CakePHP4でGoogle APIを使用してカレンダーの予定を取得したり、追加、編集、削除をする方法を紹介します。
前回のブログにGoogleカレンダー側での連携準備の仕方を説明しておりますので先にこちらをお読みください。

前提として既にGoogleのアカウントを持ち、CakePHP4は「Amzon Linux2」上にインストール済みかつ、前回のブログの内容の作業をを実施しているの想定です。またウェブサーバーは「Apache/2.4.46」、DBは「5.5.68-MariaDB」になります。
主にコードを紹介することが中心です。まず、GoogleのAPIを使うために必要なライブラリをインストールしましょう。
carbonは日時のフォーマット変更で使用します。

次にDatabaseにスケジュールを管理するテーブルを作成します。今回は「schedules」という名前で作成します。
テーブルの詳細は以下となります。

●各種カラム詳細・title　スケジュールタイトル(ex:第▲▲ 〇〇会)

creator_id　作成者のid(usersテーブルid)　※
location　開催場所(ex:〇〇会議室、▲▲ビル5F)　※
location_url　開催場所のHPのURL　※
date　開催日
start_time　開催時刻
end_time　終了時刻
remarks　スケジュール説明文
calendar_id　Googleカレンダーにスケジュール追加時に発行されるID
created　作成日時
modified　編集日時

※　任意で追加してください。

bakeコマンドを実行してでTemplate,Controller,Modelファイルを生成しましょう。以下のファイルが生成されます。
src/Controller/SchedulesController.php
src/Model/Table/SchedulesTable.php
src/Model/Entity/Schedule.php
templates/Schedules/index.php, add.php, edit.php, view.php(今回はview.phpは使用しません)

予定追加機能

まず作成したSchedulesController.phpをまず編集していきましょう。
新規にスケジュールを作成するadd()にAPI用の処理を書き加えます。
各種処理の説明はコメントを付けましたので確認してください。
また、今回はAPI処理専用のコンポーネント「ApiComponent.php」を作成してみます。
componentファイルは以下のbakeコマンドで作成できます。
bin/cake bake component [コンポーネント名]
src/Controller/Component　配下にApiComponent.phpが作成されます。

SchedulesController.php

ControllerファイルでComponentを使用するためには下記の2つのコードを加えてください。

ApiComponent.php

イベント追加する場合は上記のように設定します。
先ほどインストールしたライブラリを使えるように以下を必ず入れてください。

以上で準備完了です。実際にフォームに入力してカレンダーに追加されるか確認します。
下記が入力フォームです(/schedules/add)こちらはlabel等を分かり易いように日本語に書き換えています。