プログラミング

PHPポケモン「コントローラー編」〜POSTとSESSIONの活用〜 10

PHP PHPポケモン ポケモン
PHPポケモン「コントローラー編」〜POSTとSESSIONの活用〜 10

 

今回のPHPポケモンでは、今まで作った機能用のコントローラーになるインターフェースを作成します。ポケモンやメソッドを選択できるようにして、よりゲーム性の高いアプリケーションを実装しましょう。

 

第1回から学習したい方はコチラ

ピカチュウから学ぶオブジェクト指向 〜入門編〜 1 ピカチュウから学ぶオブジェクト指向 〜入門編〜 1

オブジェクト指向とは  オブジェクト指向プログラミング https://ja.wikipedia.org/wiki/オブジェクト指向プログラミング オブジェクト指向プログラミングとは、互いに密接な関連性を持つデータとメソッドをひとつにまとめてオブジェクトとし、それぞれ異なる性質と役割を持たせたオブジェクトの様々な定...

 

 

コントローラーの実装

 

それでは実装したアクションをインターフェースから操作できるように、コントローラーを作成します。

コントローラーといっても、本来のPHP(フレームワーク等)のControllerとは少し違った使い方をします。あくまで、ゲームのコントローラーに近い立ち位置として、選択したアクションを処理するためのクラスです。

 

それではまず、新しくControllerのクラスを作成しましょう。

 

コントローラー(/Classes/Controller.php
<?php
 
require_once(__DIR__.'/Pokemon/Pikachu.php');
require_once(__DIR__.'/Pokemon/Fushigidane.php');
 
// コントローラー
class Controller
{
 
    /**
    * ポケモン
    * @return object
    */
    public $pokemon;
 
    /**
    * @return void
    */
    public function __construct()
    {
    }
 
    /**
    * 配列のHTML出力用メソッド
    *
    * @param array
    * @var void
    */
    protected function echoKeyToVal($array)
    {
        foreach($array as $key => $val){
            echo '<p>'.$key.':'.$val.'</p>';
        }
    }
}

 

準備として、ポケモンの格納用プロパティ(pokemon)と出力ファイルで使っていたechoKeyToValの関数をメソッドを作成しておきます。ポケモンの格納プロパティは出力ファイルから呼び出しをすることになるので、アクセス修飾子はpublicです。

 

 

POSTフォームの活用

 

今回はPHPで実装するので、POSTフォームでデータの受け渡しをしながらアクションを選択します。

※ゲーム性を追求する方は、JavaScriptでajaxを使うと良いでしょう。今回は簡易のコントローラーを実装するため、PHPだけでできるようのPOSTを活用します

 

 

ポケモンの選択

 

ではまずポケモンの選択ができるように、プルダウンを作成しましょう。

 

出力用ファイル(/index.php
<?php
 
require_once(__DIR__.'/Classes/Controller.php');
 
$controller = new Controller($_POST);
 
?>
 
<form action="/" method="post">
    <select name="pokemon">
        <option value="Fushigidane">フシギダネ</option>
        <option value="Pikachu">ピカチュウ</option>
    </select>
    <input type="submit">
</form>

 

まずはコントローラーのクラスをインスタンス化します。$_POSTはグローバル変数ですが、今回はクラス内でそのまま呼び出さずに引数として渡して活用します。

 

フォームでは、pokemonというキー(name)で各ポケモンを選択できるようにします。ポケモンのデータはクラスのため、valueにはクラス名をセットします。

<option value="Fushigidane">フシギダネ</option>
<option value="Pikachu">ピカチュウ</option>

 

次に、コントローラーで送信データに合わせた分岐を作成しましょう。

 

コントローラー(/Classes/Controller.php
/**
* @return void
*/
public function __construct($post)
{
    if(empty($post)){
        // ポケモンをゲットする前
        echo '<p>ポケモンを選んでください</p>';
    }elseif(!isset($post['action'])){
        // ポケモンをゲットした
        $this->checkPokemon($post['pokemon']);
    }else{
        // アクションを選択した
    }
}
 
/**
* ポケモンクラスの存在チェック
*
* @param string $pokemon(class_name)
* @var void
*/
private function checkPokemon($pokemon)
{
    if(class_exists($pokemon)){
        $this->pokemon = new $pokemon;
    }else{
        echo '選択されたポケモンは存在しません';
    }
}

 

それではまず、コンストラクタの分岐から確認していきましょう。

if(empty($post)){
    // ポケモンをゲットする前
    echo '<p>ポケモンを選んでください</p>';
}else{
    // ポケモンをゲットした
    $this->checkPokemon($post['pokemon']);
}

 

初期状態(ページ起動時)は引数で受け取った送信データ$postは空です。なので、emptyで空判定をして、ポケモンも選択メッセージを出力します。

もし空でなければ、ポケモンをゲット(選択されたポケモンのインスタンス化)を実行します。存在しないポケモンが選択されてしまわないように、合わせてコントローラー無いに作成したcheckPokemonというメソッドを使ってポケモンを判別します。

private function checkPokemon($pokemon)
{
    if(class_exists($pokemon)){
        $this->pokemon = new $pokemon;
    }else{
        echo '選択されたポケモンは存在しません';
    }
}

 

引数で受け取った$pokemonにはポケモンのクラス名が入っています。なので、class_existsの関数を仕様して、対象のポケモンクラスが存在しているかをチェックしています。

 

もし存在していれば、pokemonのプロパティにインスタンス化します。

$this->pokemon = new $pokemon;

 

クラス名に変数を使いたい場合は、「new + 変数」と宣言すれば該当クラスを呼び出すことができます。

 

それでは、フォームの挙動を確認してみましょう。

 

フシギダネを選択した場合

ピカチュウを選択した場合

 

 

それぞれをインスタンス化した際のメッセージが表示されていますね。これでフォームを使ったポケモンの選択ができるようになりました。

 

 

セッションの活用

 

次に作成したメソッドの呼び出しをフォームからできるようにします。それには、インスタンス化したポケモンのデータを引き継がなければなりません

ですが、postデータにオブジェクトは選択できず、json形式で送信するにしてもpublicしか引き継がれないという問題が残ります。

なので、今回は簡単に実装できるようにセッションを活用してポケモンのインスタンスを受け渡します

 

出力用ファイル(/index.php
<?php
 
require_once(__DIR__.'/Classes/Controller.php');
 
session_start();

 

セッションを使うため、session_startを追記しておきます。session_startはhtml出力前に記述するようにしておきましょう。 

 

 

アクションの実装

 

それでは、メソッドを呼び出せるようにフォームを追加していきます。まずはgetDetailsgetStatsの2つを呼び出せるようにしましょう。

 

出力用ファイル(/index.php
<?php
 
require_once(__DIR__.'/Classes/Controller.php');
 
session_start();
 
$controller = new Controller($_POST, $_SESSION);
$action_list = [
    'getStats' => 'ステータス',
    'getDetails' => '詳細',
];
?>
<form action="/" method="post">
    <?php if(is_object($controller->pokemon ?? null)): ?>
        <?php $_SESSION['pokemon'] = $controller->pokemon; # ポケモンのインスタンスをセッションに格納 ?>
        <ol>
            <?php foreach($action_list as $action => $title): ?>
                <li>
                    <input type="radio" name="action" id="<?=$action?>" value="<?=$action?>">
                    <label for="<?=$action?>"><?=$title?></label>
                </li>
            <?php endforeach; ?>
        </ol>
    <?php else: ?>
        <select name="pokemon">
            <option value="Fushigidane">フシギダネ</option>
            <option value="Pikachu">ピカチュウ</option>
        </select>
    <?php endif; ?>
    <input type="submit">
</form>

 

まずはコントローラーのインスタンス化の引数に、セッションを追加します。

$controller = new Controller($_POST, $_SESSION);

 

$_SESSIONもグローバル変数ですが、$_POST同様に直接呼び出しをせずに引数で渡して管理します。

 

次に、メソッドを配列で用意します。

$action_list = [
    'getStats' => 'ステータス',
    'getDetails' => '詳細',
];

 

キーにメソッド名、値にタイトルとしておきましょう。用意した$action_listはフォームの選択肢として活用します。

 

次に、フォームの内容を分岐させます。

<form action="/" method="post">
    <?php if(is_object($controller->pokemon ?? null)): ?>
        <?php $_SESSION['pokemon'] = $controller->pokemon; # ポケモンのインスタンスをセッションに格納 ?>
        <ol>
            <?php foreach($action_list as $action => $title): ?>
                <li>
                    <input type="radio" name="action" id="<?=$action?>" value="<?=$action?>">
                    <label for="<?=$action?>"><?=$title?></label>
                </li>
            <?php endforeach; ?>
        </ol>
    <?php else: ?>
        <?php
        // ポストとセッションをリセット
        $_POST = [];
        $_SESSION = [];
        ?>
        <select name="pokemon">
            <option value="Fushigidane">フシギダネ</option>
            <option value="Pikachu">ピカチュウ</option>
        </select>
    <?php endif; ?>
    <input type="submit">
</form>

 

初期状態(ポケモンを捕まえる前)はメソッドを選択できません。なので、publicで準備したコントローラークラスのpokemonプロパティをis_objectでチェックしています。

もしポケモンをゲットできていれば、セッション($_SESSION [‘pokemon’])インスタンス化したポケモンのデータ($controller->pokemon)をセットします。

 

メソッドの選択は複数選択が出来ないようにラジオボタンで作成します。

<ol>
    <?php foreach($action_list as $action => $title): ?>
        <li>
            <input type="radio" name="action" id="<?=$action?>" value="<?=$action?>">
            <label for="<?=$action?>"><?=$title?></label>
        </li>
    <?php endforeach; ?>
</ol>

 

$action_listforeachで回しながら、nameactionにして出力します。

 

それでは、コントローラー側にアクション用のメソッドを追加しましょう。

 

コントローラー(/Classes/Controller.php
/**
* @return void
*/
public function __construct($post, $session)
{
    if(empty($post)){
        // ポケモンをゲットする前
        echo '<p>ポケモンを選んでください</p>';
    }elseif(!isset($post['action'])){
        // ポケモンをゲットした
        $this->checkPokemon($post['pokemon']);
    }else{
        // アクションを選択した
        $this->pokemon = $session['pokemon'];
        $this->action($post['action']);
    }
}
 
/**
* アクション
*
* @param string $action(method_name)
* @var void
*/
private function action($action)
{
    $result = $this->pokemon->$action();
    switch ($action) {
        case 'getDetails':
        $this->echoKeyToVal($result);
        break;
 
        case 'getStats':
        $this->echoKeyToVal($result);
        break;
 
        default:
        break;
    }
}

 

まずはコンストラクタにアクションの分岐を追加します。アクションがなければポケモンをゲットした状態、あればアクションが選択された状態という判定をしています。もしアクションが選択されていれば、第2引数で渡したセッション($session)をポケモンプロパティ($this->pokemon)にセットして、新しく作成したアクションメソッド(action)を呼び出しています。

/**
* アクション
*
* @param string $action(method_name)
* @var void
*/
private function action($action)
{
    $result = $this->pokemon->$action();
    switch ($action) {
        case 'getDetails':
        $this->echoKeyToVal($result);
        break;
 
        case 'getStats':
        $this->echoKeyToVal($result);
        break;
 
        default:
        break;
    }
}

 

変数を使用してメソッドを呼び出す際は「-> + 変数 + ()」とすることで呼び出すことができます。メソッドによっては、返り値が合ったり出力方法が異なるものもあるため、switchを使い、メソッドによって分岐させています。今回実装するgetDetailsgetStatsはどちらも返り値は配列のため、echoKeyToValのメソッドを使って出力しています。

※今回はTraitを使用しているため、現在はメソッドの判定を追加していません。もし気になる人は、try-cacthなどを使用して判定するようにしてください。

 

それでは、ポケモンを選択してメソッドを呼び出してみましょう。

 

フシギダネを選択

 

 

getStatsのメソッドを呼び出し

 

getDetailsのメソッドを呼び出し

 

 

これで、ポケモンの情報を引き継いだ状態でgetStatsgetDetailsのメソッドを呼び出すことができました。

 

 

リセット機能

 

最後にリセット機能を作成しましょう。今のままだと、ポケモンを選択してしまうとウィンドウ(タブ)を閉じない限りポケモンを変更することができません。なので、アクションに「リセット」を追加します。

 

出力用ファイル(/index.php
$action_list = [
    'getStats' => 'ステータス',
    'getDetails' => '詳細',
    'reset' => 'リセット',
];
 
--省略
 
<?php else: ?>
    <?php
    // ポストとセッションをリセット
    $_POST = [];
    $_SESSION = [];
    ?>
    <select name="pokemon">
        <option value="Fushigidane">フシギダネ</option>
        <option value="Pikachu">ピカチュウ</option>
    </select>
<?php endif; ?>

 

$action_listにリセット(reset)と、初期画面用の分岐内に$_POSTと$_SESSIONを初期化する処理を追加しました。リセットのアクションが選択された場合、初期画面のフォームを表示させ、既に格納されたセッションとポストデータを空にしています。

 

resetというメソッドは用意されていないため、このまま呼び出せばエラーが発生してしまいます。そうならないように、コントローラーのアクションメソッドにreset用の分岐を追加します。

/**
* アクション
*
* @param string $action(method_name)
* @var void
*/
private function action($action)
{
    if($action === 'reset'){
        // 初期化
        $this->pokemon = null;
        return;
    }
   
    $result = $this->pokemon->$action();
    switch ($action) {
        case 'getDetails':
        $this->echoKeyToVal($result);
        break;
 
        case 'getStats':
        $this->echoKeyToVal($result);
        break;
 
        default:
        break;
    }
}

 

もしアクションがresetであれば、pokemonプロパティにセットされたインスタンスを初期化して処理を終了させています。これで、出力されるフォーム分岐で初期画面が表示され、$_POST$_SESSIONも初期化することができます。

 

それでは動きを確認してみましょう。

  

リセットを実行

 

 

これでリセット機能が実装されました。これでポケモンを選択し直すことができます。

 

 

まとめ

 

いかがだったでしょうか。

今回のPHPポケモンでは「コントローラー」を実装しました。操作する機能が追加されたので、今までと比べるとゲーム性が出て楽しくなりましたね。

POSTフォームはお問い合わせ等でよく使用されますが、このようにデータの受け渡しにも使えるため便利です。ただし、リリースする際はサニタイズするなどして、悪意ある入力を防ぐようにしておきましょう

  

注目の記事

ピカチュウから学ぶオブジェクト指向 〜レベルアップ編〜 5
プログラミング
PHP,PHPポケモン,オブジェクト指向,ポケモン
ピカチュウから学ぶオブジェクト指向 〜レベルアップ編〜 5

  第3回でレベルシステムを導入し、第4回では経験値システムの導入をしたので、今回はそれを合わせたレベルアップのシステムを導入します。 第1回から作成しているコードを使用しているので、もし最初から学習したい人は第1回の入門編をご覧ください。     レベルアップシステムの導入   レベル...

PHPポケモン「状態異常編〜まひ〜」23
プログラミング
PHP,PHPポケモン,ポケモン
PHPポケモン「状態異常編〜まひ〜」23

  今回のPHPポケモンでは「状態異常」を導入します。バトルシステムにも関係してくる部分ですが、それ以外にも影響を与える部分が多く、且つ非常に判定がややこしく、作り込む必要があったため1つずつ片付けていきます。   状態異常の実装  ポケモンの除隊異常に該当するものは以下の7通りです。 ...

反動技編(はかいこうせん・とびひざげり)PHPポケモン40
プログラミング
PHP,PHPポケモン,ポケモン
反動技編(はかいこうせん・とびひざげり)PHPポケモン40

反動技とは ポケモンでは反動技というものがあります。反動によっても様々で、現在の仕組みのままでも実装可能なものや、新たに処理が必要なものまであります。なので、一律で反動技という同じ処理は出来ません。  反動技(ポケモンwiki) https://wiki.ポケモン.com/wiki/反動技 反動技(はんどうわざ...

HPバー色変更編(アニメーション) PHPポケモン53
プログラミング
PHP,PHPポケモン,ポケモン
HPバー色変更編(アニメーション) PHPポケモン53

HPバーの色変更 残りHPの割合に合わせて色クラスをセットしていましたが、ダメージを受けた際の判定処理(動的は変更)が未実装でしたので、今回はコチラを対応します。   残数(割合)の判定 HPの色判定は、HTMLの描画時とJSによるHP変動時に行います。animateメソッド前や後に行うと変更のズレが生じるため、a...

【Wi-Fi6とは】スマホやPCの買い替えは必要?騙されないための基礎知識
ネットワーク
5G,IEEE 802.11ax,Wi-Fi
【Wi-Fi6とは】スマホやPCの買い替えは必要?騙されないための基礎知識

  本格的に5G普及への取り組みが始まり、Wi-Fi6といった新世代の規格が出たことによって、超情報化社会へ加速しました。 ですが、こういったナンバリングが一般化することによって、わからずに高性能な機器を斡旋されて無駄な購入をさせられたり、わからないことを理由に詐欺的営業を仕掛けてくる悪意ある人...

動画編集に役立つ基本的な考え方【Adobe AfterEffects】
動画編集
Adobe,AfterEffects,PremierePro,YouTube
動画編集に役立つ基本的な考え方【Adobe AfterEffects】

  YouTubeの人気に合わせて、動画編集の需要も高まってきましたが、その大変さから挫折してしまう人も続出しています。 動画編集は奥が深く、技術的な部分に関してはプロのクリエイターであっても自分がよく使うような一部しか把握していないのが普通であり、調べても該当する情報が出てきにくいということもあ...

本当に価値のある宣伝方法 〜多くの人が実践している【間違った努力】とは〜
マーケティング
Facebook,note,Twitter,YouTube,集客
本当に価値のある宣伝方法 〜多くの人が実践している【間違った努力】とは〜

  YouTubeやTwitter、Facebookやnoteなど、いろんなサービスを使った集客方法があります。集客という視点ではなく、それ自体に人を集めたいという人も多いでしょう。   フォロワーやチャンネル登録者数を増やすために、多くの人が様々な取り組みをしていますが、その中でもひときわ意味のないことをただ繰り返して...

システムエンジニアとプログラマーの違いって?仕事内容や必要スキルについてわかりやすく解説します【SE・PG】
プログラミング
システムエンジニアとプログラマーの違いって?仕事内容や必要スキルについてわかりやすく解説します【SE・PG】

  システムエンジニアってどんな仕事? プログラマーとどう違うの?   プログラミング教育が必修化になり、SEやPGの職業が注目された今、この違いについてわからない、教えて欲しいという質問が後を絶ちません。 今回はそういった人たちのために、システムエンジニア(SE)とプログラマー(PG)という職業に...

カテゴリ

SEO対策 イベント デザイン ネットワーク ビジネスモデル フリーランス プログラミング マーケティング ライティング 動画編集 雑記

タグ

5G Adobe AfterEffects AI ajax amazon Animate api artisan atom Automator AWS Bluetooth CSS CVR description EC-CUBE4 ECショップ ESLint Facebook feedly foreach function Google Google AdSense Honeycode htaccess HTML IEEE 802.11ax Illustrator Instagram IoT JavaScript jQuery jQuery UI keyword LAN Laravel Linux MacBook MAMP meta MLM MySQL NoCode note OS OSI参照モデル Paypal Photoshop PHP phpMyAdmin PHPポケモン PremierePro rss SEO SEO対策 Sequel Pro Skype SNS SSH Symfony TCP/IP title Toastr Trait Twig Twitter UCC V系 WAN WebSub Wi-Fi wiki Windows WordPress XAMPP xml Xserver YouTube YouTuber Zoom アーティスト アウトプット アクセス層 アニメーション アフィリエイト イーブイ インターネット インプット エンジニア オブジェクト指向 お金配り クリック単価 クリック数 コミュニケーション能力 コロナ コンサルティング サムネイル システムエンジニア スタートアップ スタイルシート スパム データベース ディープフェイク デザイナー デザイン テレワーク ナンパ ニュース ネットワークモデル ノマドワーク バナー ピカチュウ ビジネス フィード フリーランス ブロガー ブログ プログラマー プログラミング プログラミング学習 プログラミング教育 プロトコル ホームページ制作 ポケモン マークアップ マーケティング メール リモートワーク レンダリング 三井住友 三宮 仕事依頼 児童デイ 児童デイサービス 児童発達支援 公開鍵 初心者 助成金 勉強法 営業 広告 広告収入 必勝マニュアル 放課後等デイサービス 朝活 楽天 深層学習 無線LAN 独立 神戸 福祉 秘密鍵 翻訳 自己啓発 英語 見積書 計算機 読書 起業 迷惑メール 配列 銀の弾丸 集客 雑学力