プログラミング

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

  

注目の記事

お金を稼ぐためは理解しておきたい基本的な3要素【お客さんを増やす前に知っておかなければならないことって?】
マーケティング
お金を稼ぐためは理解しておきたい基本的な3要素【お客さんを増やす前に知っておかなければならないことって?】

  お客さんを増やすためにはどうすればいいんだろう?   ビジネスをやっている人で儲かっている一部を除けば、誰もが抱いている共通の悩みですね。 ですが、ただお客さんを増やすために安易な広告を打ったりするのは、実は危険なことなんです。   今回は「お金を稼ぐためには理解しておきた...

状態異常演出編 PHPポケモン 62
プログラミング
PHP,PHPポケモン,ポケモン
状態異常演出編 PHPポケモン 62

状態異常の演出 今回は「状態異常」にかかった際の動的な変更、演出を実装していきます。 どく状態になれば、メッセージに合わせて「どく」を表記、まひ状態になれば、メッセージに合わせて「まひ」をセットするという単純なものです。   返り値の変更 それではまず、状態異常をセットしてメッセージを生成して...

お金を生む仕組みを理解しよう【知っておきたい3つのポイント】
マーケティング
お金を生む仕組みを理解しよう【知っておきたい3つのポイント】

  どんなビジネスが儲かるのか・・・   一度はこういった悩みを持ったことがあるのではないでしょうか。 それを知るためには、どういった要素がお金を生むために作用しているのかを理解しておく必要があります。 今回は「お金を生む仕組み」について、知っておいてためになる基礎的な部分をわかりやすく...

進化直後の技習得編 PHPポケモン 65
プログラミング
PHP,PHPポケモン,ポケモン
進化直後の技習得編 PHPポケモン 65

進化直後の技習得 パーティー機能を導入に合わせて、至る場所を修正することになり、合わせて未実装だった機能を導入していきます。 見た目にはわからない部分や、とある条件が重ならなければ起こらない部分の作り込みが多いため、プレイユーザー目線からすると少し面白みが無いかも知れません。 ですが、そういっ...

SNS拡散力アップ!PHPでOG画像付きリッチURLを自作する方法【Curl → Opengraph】
プログラミング
PHP,WordPress
SNS拡散力アップ!PHPでOG画像付きリッチURLを自作する方法【Curl → Opengraph】

  ブログやHPにサイトのURLをただ貼り付けても、どんなページなのか一目でわからないのでなかなか思うようにアクセスに繋がりません。 ですが、毎回のようにURL先の画像を準備したり、説明文を設定するのも大変ですし、ページタイトルや画像が差し替わってしまうことも考えられます。   今回はそういった手間...

経験値分配編 PHPポケモン 89
プログラミング
PHP,PHPポケモン,ポケモン
経験値分配編 PHPポケモン 89

経験値の分配とは 大型アップデート後、最初の追加機能は「経験値の分配」についてです。 ポケモンの入れ替えができるようになりましたが、経験値をもらえるのは現在フィニッシャーのみとなっており、レベルの低いポケモンを育てるのが困難な状態です。なので、ゲームバランスを整えるためにも、まず経験値周りの処...

なぜプロは有線のマウスやキーボードを選ぶのか?【有線VS無線】
雑記
Bluetooth
なぜプロは有線のマウスやキーボードを選ぶのか?【有線VS無線】

  無線が普及する現代、何故有線のマウスやキーボードは売れているのか   いろんなものが製品の進化と共に無線化している一方、有線の需要も高く、とくにプロなど上層で活躍する人は有線を選択するケースが少なくありません。 今回は、そんな有線と無線の違いや、それぞれのメリットについて解説していき...

【Adobe Animate CC】モーショントゥイーンを使ったアニメーション作成
動画編集
Adobe,Animate,Illustrator,Photoshop,アニメーション
【Adobe Animate CC】モーショントゥイーンを使ったアニメーション作成

    今回はキャラクターがうちわを扇いでいるアニメーションのAdobe Animateを使った作成方法をご紹介します。 完成イメージは以下の通りです。   Photoshopなどを使ってもgifアニメーションの作成はできますが、Adobe Animateのモーショントゥイーンを使えば、変化するポイントだけを設定す...

カテゴリ

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 独立 神戸 福祉 秘密鍵 翻訳 自己啓発 英語 見積書 計算機 読書 起業 迷惑メール 配列 銀の弾丸 集客 雑学力