#【php】Web API関連メモ

自分用のメモです。

##namespace
namespace 名前空間名;

名前空間を定義する。
同一名のクラスや関数などが定義できるようになる。（衝突によるエラーや上書きを防ぐ）
一番上に書く。(HTMLやファイル読み込みよりも上)

▼使い方
名前空間\呼び出したいもの

名前空間\関数名()
名前空間\変数

(method.php)同一ファイルに同じ関数を書

<?php
namespace name1;
 
function hello(){
  return 'こんにちは';
}
 
namespace name2;

function hello(){
  return 'Hello';
} 
?>

(exec.php)関数の呼び出し

<?php
 
//ファイル読み込み
require_once 'method.py';
 
//関数の呼出し
echo name1\hello();
echo name2\hello();
 
?>

//出力
こんにちはHello

##use as
use 名前空間名 as エイリアス名;
名前空間を作成し、エイリアス化する
名前空間が長い場合に使う。

use AAA\BBB\CCC\DDD as name3;
　└ 名前空間「AAA\BBB\CCC\DDD」を「name3」と定義。

▼asがない場合
use AAA\BBB\CCC\DDD
　└ 名前空間は「DDD」になる

##function　関数名(array 引数)
(型引数,　型引数,,,)は型宣言。配列を指定。
渡された引数の方が指定と違う場合にエラーを返す。
間違いの早期発見用。

function test(array $list, int $val)

//$list：配列
//$val：整数

##アロー演算子(->)
##クラス名->$プロパティ名
クラス名->$プロパティ名
指定したクラスのプロパティを取得。

クラス内で呼び出す場合は、$this->$プロパティ名

※アロー関数はJS

##インスタンス名->関数名()
インスタンス名->関数名()
インスタンスの中で関数を呼び出す。
　└ インスタンスの入った変数。

##require dirname(DIR). '絶対パス';

ファイルを読み込む。

//以下は同じ
require dirname(__DIR__) . '/path/ファイル名.php';
require dirname(__FILE__) . '/path/ファイル名.php';
require ( __DIR__ . '/path/ファイル名.php');

require dirname(__DIR__) . '/vendor/test.php';

この場合、後から追加したライブラリ(vendorが保存場所)のtest.phpというファイルを読み込んでいる。

$this->request->controller;
$this->request['controller'];
$this->request->params['controller'];

##コメントアウト + @（アットマーク）

パラメータや変数の説明。

//@param [型] 変数名説明
//@var [型] 説明
//@return [型] 説明

▼使用例

class Userdb
{
    private $name;
    private $db;

    /**
     * コンストラクタ
     *
     * @param Users $name
     * @param Database $db
     */
    public function __construct(Users $name, Database $db)
    {
        $this->name = $name;
        $this->db = $db;
    }

キー=>値

連想配列のキーと値の指定は「=>」

array (key1=>値1, key2=>値2, key3=>値3,,,)
キーの名前で値を呼び出す

##array_shift
array_shift(配列名)
配列の一番最初の要素を抜き出す。
破壊的。実行後、元の配列からその要素が抜ける。

$lists=array("aaa","bbb","ccc");
$data1=array_shift($lists);

echo "0番目の要素：".$data1."。<br>";
print_r($lists);


////出力
//0番目の要素：aaa
//("bbb","ccc");

##argc, argv
$argc: 引数の個数（Argument Count）

▼ファイル実行時に、引数を渡し、その引数の値をつかう

if ($argc === 1) {
    echo '引数は1つです', PHP_EOL;
    exit(1);
}

$argv: 引数の値 (Argument Value)

//入力値 aaa bbb ccc
$argv[0] //aaa
$argv[1] //bbb
$argv[2] //ccc

//変数に格納
$answers = $argv

##PHP_EOL
実行環境のOSで改行を行う。

実行環境に合わせ、下記に変換される。
・windows:「\r\n(CRLF)」
・Linux系: 「\n(LF)」

echo "aaa".PHP_EOL."bbb".PHP_EOL."ccc";

////出力
//aaa
//bbb
//ccc

##eixt()
処理の終了

exit(整数)
エラーのステータスコードを整数にする。
画面表示はされない。

##json_decode関数
JSON形式のデータを変換する。

$a = json_decode(JSON形式のデータ)
　└ オブジェクトを返す
　└ {"obj1":値1,"obj2":値2}
　└ $a{obj1} →　値1

$a = json_decode(JSON形式のデータ, true)
　└ 連想配列に変換
　└ array(obj1=>値1, obj2=>値2)
　└ $a[obj1] → 値1

##Pimple

DIコンテナの一つ
インスタンスの生成を一括実行するファイル。
DI用の設定データを保存しているcontainer.php
「$変数名= インスタンス生成処理」が省略できる
引数の数が大幅に減る

use Pimple\Container;
$container = new Container();

//または
$container = new Pimple\Container();

##DI
DI：Dependency Injection

依存性のあるデータ（インスタンスの生成）などを変数で与える。

クラスとの依存性が低くなるため、動的に変更可能になる。
クラスをいじらず、注入しているデータ元をいじれる（メンテ簡略化）

##guzzle http
外部APIの実行。

//guzzleのりーソスを生成し、requestメソッドで送信
new GuzzleHttp\Client([
        'handler' => $handler,
        'base_uri' => 'http://www.example.com',
    ]);

base_uri: アクセスするURLのベースとなるもの。（必須）
handler: リクエストヘッダーにつけるパラメータを指定。配列形式で複数指定可能。（オプション）

▼応答データの取得（文字列）

$response->getBody()

###request

Client->request('メソッド', 'URL');
　└ メソッド：GET or POST

指定したURL（またはパス）からデータを取得する。

$response = Client->request('POST','/test', ['json' => データ]);

・Client= GuzzleHttp\Client
・/testファイルにjson形式でデータを渡し、その結果をPOSTで受け取り、$responseに格納.

##Cake PHP
ruby on railsの思想をベースに作成したPHP用のフレームワーク。

▼Cake PHP

コマンドや規則が充実。
スピード感重視で作成できる。
自由度が低い。

▼Lravel

自由度が高い
最新技術も導入しやすい

簡単なサイト作成ならCake PHP, がっつり組みたいならLaravel。

###インストール
composerで行う
　└ 作業ディレクトリ毎にインストール

composer install

###MVCモデル
Model（Routing）
View
Controller

Controller(処理の割り振り) -> Model（データ処理）-> View(表示)

###ディレクトリ構成

####PJディレクトリ

ディレクトリ	内容
cake	CakePHPの中心部分となるライブラリファイル類がまとめられている
plugins	プラグインのプログラムを組み込むためのもの
app	Webアプリケーションを配置していくディレクトリ　あらかじめ定められたルールでファイルを配置し開発していく
venders	ライブラリ類を後から追加するときに利用されるところ
gitignore	git用のファイル
htaccess	Webサーバの動作に関する設定ファイル
index.php	CakePHPのディレクトリのインデックスファイル　このディレクトリにアクセスしたときにこのページが表示される
README	最初に読むドキュメント

#####appディレクトリの中身

ディレクトリ	内容
config	CakePHPで利用される各種の設定情報を保管。Routingファイルもこの中。
libs	ライブラリファイルを追加する場所
controllers	プログラムの制御に関するソースコードを追加していく
locale	言語・地域情報に関するファイルを保管する
models	データベースアクセス関係のソースコードを追加していく
plugins	機能追加のためのプラグインファイルを追加する
tests	テストに関するフレームワークを追加する
tmp	プログラム実行中に作成される一時ファイルの保管場所
vendors	ライブラリ類を後から追加するときに利用されるところ
views	ページレイアウトのためのファイルを追加していく
webroot	CakePHPによるWebアプリケーションのルートになる　ここにファイルを入れるとルートに配置された状態で呼び出される
.htaccess,index.php	このディレクトリのWebサーバの設定情報とデフォルトページ

cakeフォルダは基本触らない
編集や追加をするのは基本appフォルダ

###Configuration
環境設定：config/bootstrap.phpから読み込まれる。

初期状態は「config/app.php」のみ存在。
自分で、「config/bootstrap.php」を追加し設定を書き込むと、 bootstrap.php側の設定が読み込まれるようになる。

インスタンスの生成や、関数の作成を行う


$product = new 名前空間\クラス名();

$product['server_db'] = function ($c) {
    return new 名前空間2\クラス名(dirname(__DIR__) . '/var/server_db.txt');
};

###Routing
「config/routes.php」で設定する。

Router::connect('入力URL', ['controller' => 'コントローラー名', 'action' => 'アクション名(開くページ)']);

config/routes.php

Router::connect('/top', ['controller' => 'Home', 'action' => 'index']);

(ドメイン)/topが入力されたら、HomeContorllerのindexというアクションを実行する。

####パラメータの取得と呼び出し

▼格納
:プレースホルダ名

▼呼び出し
['プレースホルダ名' => '\d+']

config/routes.php

Router::connect('/top/:top_id', ['controller' => 'Home', 'action' => 'index'], ['top_id' => '\d+']);

###Request

デフォルトのリクエストを扱うクラス。
リクエストのデータの管理・操作を行うときに使用
大本のデータはCake\Network\Request
呼び出し：$this->request
requestの中にパラメータが入っている。
Controller、View、Cell、Helperからアクセス可能。

▼パラメータへのアクセス方法

//param or params
$this->request->params['controller']; // 複数形(params)
$this->request->param('controller'); // 単数形(param)

▼GETのパラメータ
$this->request->query
取得データは連想配列になっている。

/home?name=aaa&age=25

$this->request->query; # array('name' => 'aaa','age' => '25')

▼POSTの場合

$this->request->data('name.aaa');
$this->request->data['name'];

###Controller

▼ファイルの場所
src/Controllers/コントローラー名Contoller.php

各ControllerはAppController(src/Controllers/AppController.php)を継承

→冒頭に「namespace App\Controller;」がある。

###saveメソッド
$this->Model->save("キー名", 値)

$this->db->save('name', 'tanaka');

▼保存したデータの取得
fetchを使う

$this->db->fetch('name');