PHPとCakePHPの連携によるWebアプリケーション開発について解説

# Composerを利用してCakePHPアプリケーションを作成

composer create-project --prefer-dist cakephp/app my_app

# 出力例

Installing cakephp/app (4.x.x)...
Created project in my_app

# CakePHP内蔵サーバーを利用してアプリケーションを起動

php bin/cake.php server --port 8765

# 出力例

CakePHP Server started on http://localhost:8765

# tmpディレクトリへの書き込み権限設定

chmod -R 755 tmp

# logsディレクトリへの書き込み権限設定

chmod -R 755 logs

// config/app.php の一部サンプルコード
'Cache' => [
    'default' => [
        'className' => 'File',
        'path' => CACHE,
        'url' => env('CACHE_DEFAULT_URL', null),
        // キャッシュの有効期限を60分に設定
        'duration' => '+60 minutes',
    ],
],

// src/Model/Table/UsersTable.php
namespace App\Model\Table;
use Cake\ORM\Table;
class UsersTable extends Table {
    public function initialize(array $config): void {
        // モデルの初期設定
        $this->addBehavior('Timestamp'); // 作成日時や更新日時を自動で管理
    }
}

// src/Controller/UsersController.php
namespace App\Controller;
use App\Controller\AppController;
class UsersController extends AppController {
    public function index() {
        // ユーザーデータの取得
        $users = $this->Users->find('all');
        // ビューに変数を設定
        $this->set(compact('users'));
    }
}

// config/routes.php
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
return static function (RouteBuilder $routes) {
    $routes->connect('/', ['controller' => 'Pages', 'action' => 'display', 'home']);
    $routes->fallbacks(DashedRoute::class);
};

// config/routes.php
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
return static function (RouteBuilder $routes) {
    $routes->setExtensions(['json']);
    $routes->resources('Articles', [
        'inflect' => 'dasherize'
    ]);
};

// src/Controller/ContactsController.php
namespace App\Controller;
use App\Controller\AppController;
class ContactsController extends AppController {
    public function submit() {
        // POSTで送信されたデータを取得
        $data = $this->request->getData();
        // 取得したデータを変数に格納し、ビューへ渡す
        $this->set(compact('data'));
    }
}

// src/Controller/ContactsController.php
namespace App\Controller;
use App\Controller\AppController;
use Cake\Http\Exception\NotFoundException;
class ContactsController extends AppController {
    public function jsonResponse() {
        // サンプルデータを作成
        $result = ['status' => 'success', 'message' => 'データの取得に成功しました'];
        // JSON形式でレスポンスを作成
        $this->set(compact('result'));
        $this->viewBuilder()->setOption('serialize', ['result']);
    }
}

# 出力例(JSON)

{
    "result": {
        "status": "success",
        "message": "データの取得に成功しました"
    }
}

// src/Controller/AppController.php
namespace App\Controller;
use Cake\Controller\Controller;
class AppController extends Controller {
    public function initialize(): void {
        parent::initialize();
        // 認証コンポーネントをロード
        $this->loadComponent('Auth');
    }
    // 共通の認証処理メソッド
    public function checkUserAuth() {
        // ユーザー認証のチェックコードを実装
    }
}

// src/Controller/UsersController.php の一部
public function listUsers() {
    // Usersテーブルから全件取得
    $users = $this->Users->find('all')->toArray();
    $this->set(compact('users'));
}

// src/Model/Table/UsersTable.php の一部
public function validationDefault(Validator $validator): Validator {
    $validator
        ->notEmptyString('username', 'ユーザー名は必須です')
        ->email('email', false, '正しいメールアドレスを入力してください');
    return $validator;
}

// src/Model/Table/UsersTable.php の一部
public function initialize(array $config): void {
    parent::initialize($config);
    // UsersテーブルがArticlesテーブルを所有(1対多)
    $this->hasMany('Articles', [
        'foreignKey' => 'user_id'
    ]);
}

// src/Template/Element/header.ctp
?>
<header>
    <h1>サイトタイトル</h1>
    <!-- ナビゲーションメニューなど -->
</header>
<?php

// 例：src/Template/Pages/home.ctp
echo $this->element('header');
?>
<main>
    <p>ホームページの内容です。</p>
</main>

// src/Controller/PostsController.php
namespace App\Controller;
use App\Controller\AppController;
class PostsController extends AppController {
    public function add() {
        // 新規投稿作成処理
        if ($this->request->is('post')) {
            // 投稿データの保存処理(サンプル)
            // 保存に成功した場合はFlashメッセージを設定
            $this->Flash->success('投稿が正常に保存されました');
        }
    }
}

// src/View/Helper/CustomHelper.php
namespace App\View\Helper;
use Cake\View\Helper;
class CustomHelper extends Helper {
    // 与えられた文字列を大文字に変換するユーティリティーメソッド
    public function toUpperCase(string $text): string {
        return strtoupper($text);
    }
}

// src/Template/Example/view.ctp
echo $this->Custom->toUpperCase('こんにちは、CakePHP！');

// config/app.php の一部サンプルコード
'Log' => [
    'debug' => [
        'className' => 'File',
        'path' => LOGS,
        'file' => 'debug',
        'levels' => ['notice', 'info', 'debug'],
    ],
    'error' => [
        'className' => 'File',
        'path' => LOGS,
        'file' => 'error',
        'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
    ],
],

// src/Controller/PostsController.php の一部
public function delete($id = null) {
    try {
        // 投稿の削除処理を実行(サンプル実装)
        if (!$id) {
            throw new \Exception('IDが指定されていません');
        }
        // 削除処理(例)
        $result = $this->Posts->deletePost($id);
        if ($result) {
            $this->Flash->success('投稿が削除されました');
        }
    } catch (\Exception $e) {
        // エラーメッセージを表示
        $this->Flash->error($e->getMessage());
    }
}

// config/app.php の一部サンプルコード
'debug' => filter_var(env('DEBUG', true), FILTER_VALIDATE_BOOLEAN),

// src/Application.php の一部
public function bootstrap(): void {
    parent::bootstrap();
    // プラグインの読み込み
    $this->addPlugin('MyPlugin');
}