PHP tool - 版の履歴

Senooken: Methods @throws

2025-10-02T06:43:19Z

Methods @throws

@@ 79行目: / 79行目: @@
   {@tag value}
-==== @return ====
+==== inheritance ====
 [https://docs.phpdoc.org/guide/references/phpdoc/tags/return.html#return phpDocumentor]
@@ 89行目: / 112行目: @@
 ただ、関数の@returnでreturnが何を返すのかを書いた方がいい。
 ==== 注意喚起 ====
@@ 242行目: / 268行目: @@
 この方法を使わない場合、同じプロパティーを初期値指定で再定義しないといけない。@propertyで指定するとそれを回避できる。
-==phpDocumentor==
+=== phpDocumentor ===
 Ref: [https://phpdoc.org/ Home | phpDocumentor].

Senooken: プロセス

2025-09-09T01:31:52Z

プロセス

← 古い版		2025年9月9日 (火) 10:31時点における版
2,498行目:		2,498行目:

	共通テストメソッドはassertXxxにする。testXxxはPHPUnitのtest対象になるので。		共通テストメソッドはassertXxxにする。testXxxはPHPUnitのtest対象になるので。

			===== プロセス =====
			https://grok.com/share/c2hhcmQtMw%3D%3D_e1586c8a-b519-44be-b04d-185e61969ae2

			phpunitは基本的に同一プロセスで全テストを実行する。その都合で、あるファイルでincludeしたシンボルはグローバルに存在するので、他のファイルにも影響ある。

			あるファイルAでincludeしてシンボルAAが登場して、別のファイルBでincludeするファイル内にシンボルBBがある場合、エラーになる。

			対策がいくつかある。

			* 名前空間を活用してシンボル衝突を防ぐ。
			* phpunit --process-isolationのオプションを指定。ただし、遅くなる。
			* テストスイートの分離。

			根本的には、同じシンボルが複数ファイルでグローバルで登場するのがまずい。名前空間、require_once、function_existsとかでガードすべき。元ファイルが想定していないなら、--process-isolationオプションを使う。
	[[Category:PHP]]		[[Category:PHP]]

Senooken: .inc/.include/.class

2025-09-03T00:59:45Z

.inc/.include/.class

← 古い版		2025年9月3日 (水) 09:59時点における版
876行目:		876行目:

	PDOなどのDB接続インスタンスは、メインスクリプトで従来通り毎回書くか、シングルトンかstaticメソッドで管理して渡すとか。		PDOなどのDB接続インスタンスは、メインスクリプトで従来通り毎回書くか、シングルトンかstaticメソッドで管理して渡すとか。

			===== .inc/.include/.class =====
			https://grok.com/share/c2hhcmQtMw%3D%3D_6193ad5e-6df3-42c7-9dbc-dc67deb44bcd

			phpファイルが直接応答を返す古いパターンだと、拡張子が.inc/.include/.classなど.phpじゃないことがある。

			公開ディレクトリーに、同居する都合、サーバーアクセスで拡張子で、アクセス制御しているからだろう。

			本来であれば、現代的なpublic/index.phpでコントローラーを明示的に振り分けて、ユーザーがアクセス可能なディレクトリーを制限すべきだろう。

	=== PHP ===		=== PHP ===

Senooken: /* bootstrap */

2025-09-02T07:50:31Z

bootstrap

← 古い版		2025年9月2日 (火) 16:50時点における版
1,579行目:		1,579行目:
	\|該当するスーパーグローバル変数の設定。		\|該当するスーパーグローバル変数の設定。
	\|}		\|}
			GuzzleのHTTPクライアントでプロキシー設定無視で以下の設定はよく使うかもしれない。
			<php><env name="NO_PROXY" value="*"/></php>

	===== bootstrap =====		===== bootstrap =====

Senooken: /* bootstrap */

2025-09-02T07:49:23Z

bootstrap

@@ 1,558行目: / 1,558行目: @@
+|
 |include_pathの先頭に追加するパス。
 |}

Senooken: /* 仕様化テスト/Characterization test */

2025-08-28T03:30:38Z

仕様化テスト/Characterization test

← 古い版		2025年8月28日 (木) 12:30時点における版
754行目:		754行目:

	仕様化テストだから、Baseじゃなくて、Baselineとするのがいい。assertBaseline/testBaselineでやると、一貫性ある命名規則にできる。		仕様化テストだから、Baseじゃなくて、Baselineとするのがいい。assertBaseline/testBaselineでやると、一貫性ある命名規則にできる。

			https://grok.com/share/c2hhcmQtMw%3D%3D_57517641-d440-468e-ae2e-956958ce27f9

			API系の場合、結合テストに近い。サーバーを立てて、リクエストを送って、レスポンスがどうなるかをテストする感じ。

			一部クラスになっている場合も、基本は現在の挙動確認。現在の挙動を確認するような動作のテストをする。最終出力回りを重点的に書くとよい。

	===== 関数抽出 =====		===== 関数抽出 =====

Senooken: /* クラス化 */

2025-08-26T02:14:54Z

クラス化

← 古い版		2025年8月26日 (火) 11:14時点における版
800行目:		800行目:

	===== クラス化 =====		===== クラス化 =====
			https://grok.com/share/c2hhcmQtMw%3D%3D_21361425-16d6-419a-84ae-3c793d627eef

	シンプルで無難なMVCの形でクラス化する。		シンプルで無難なMVCの形でクラス化する。

866行目:		868行目:
	if (!debug_backtrace()) {}		if (!debug_backtrace()) {}
	このコードでincludeとの違いも検知できる。		このコードでincludeとの違いも検知できる。

			PDOなどのDB接続インスタンスは、メインスクリプトで従来通り毎回書くか、シングルトンかstaticメソッドで管理して渡すとか。

	=== PHP ===		=== PHP ===

Senooken: クラス化

2025-08-26T02:10:03Z

クラス化

← 古い版		2025年8月26日 (火) 11:10時点における版
798行目:		798行目:

	長期保守前提であれば、関数化の段階をすっ飛ばして、オブジェクト・クラス化したほうが手っ取り早い。		長期保守前提であれば、関数化の段階をすっ飛ばして、オブジェクト・クラス化したほうが手っ取り早い。

			===== クラス化 =====
			シンプルで無難なMVCの形でクラス化する。

			* DB操作: Modelクラス
			* 画面表示: Viewクラス
			* ロジック呼び出し: Controllerkクラス
			'''コード例''':
			Model (models/UserModel.php):
			class UserModel {
			private $db;

			public function __construct(PDO $db) {
			$this->db = $db;
			}

			public function fetchUser($id) {
			$stmt = $this->db->prepare("SELECT * FROM users WHERE id = ?");
			$stmt->execute([$id]);
			return $stmt->fetch();
			}
			}
			View (views/UserView.php):
			class UserView {
			private $smarty;

			public function __construct(Smarty $smarty) {
			$this->smarty = $smarty;
			}

			public function renderUser($user) {
			$this->smarty->assign('user', $user);
			return $this->smarty->fetch('user.tpl');
			}
			}
			Controller (controllers/UserController.php):
			class UserController {
			private $model;
			private $view;

			public function __construct(UserModel $model, UserView $view) {
			$this->model = $model;
			$this->view = $view;
			}

			public function handleRequest() {
			$id = $_GET['id'];
			$user = $this->model->fetchUser($id);
			return $this->view->renderUser($user);
			}
			}
			メインスクリプト (user.php):
			<?php
			require 'autoload.php'; // Composerのautoload
			$db = new PDO('...');
			$smarty = new Smarty(); // Smartyセットアップ
			$model = new UserModel($db);
			$view = new UserView($smarty);
			$controller = new UserController($model, $view);
			header('Content-Type: text/html; charset=UTF-8');
			$output = $controller->handleRequest();
			echo $output;
			?>
			これでMVCパターンに近づく。SmartyをViewクラスでラップしてテストしやすく。

			あるいは、メインスクリプトをControllerとみなして、constructorで画面表示処理を書くというのもありかもしれない。
			if (!debug_backtrace()) {}
			このコードでincludeとの違いも検知できる。

	=== PHP ===		=== PHP ===

Senooken: 関数抽出

2025-08-26T01:13:21Z

関数抽出

@@ 687行目: / 687行目: @@
 改善手順がある。
 ===== 仕様化テスト/Characterization test =====
@@ 748行目: / 754行目: @@
 仕様化テストだから、Baseじゃなくて、Baselineとするのがいい。assertBaseline/testBaselineでやると、一貫性ある命名規則にできる。
 === PHP ===

Senooken: 親クラスBaseTestCase

2025-08-25T07:27:34Z

親クラスBaseTestCase

← 古い版		2025年8月25日 (月) 16:27時点における版
2,328行目:		2,328行目:

	ネスト構造はクラスとメソッドの親子関係での表現になる。分けたかったら、テストメソッドの命名規則などになる。		ネスト構造はクラスとメソッドの親子関係での表現になる。分けたかったら、テストメソッドの命名規則などになる。

			===== 親クラスBaseTestCase =====
			テストクラスで、共通の処理とかしたいことがある。親クラスにまとめたい。

			PHPUntはTestCaseがテスト対象じゃないことを意味するので、親クラスも最後はTestではなくてTestCaseにする。

			https://grok.com/share/c2hhcmQtMw%3D%3D_0cfa311d-b290-4d5b-9183-ca7f7efb2d53

			BaseTestCaseとか。

			共通テストメソッドはassertXxxにする。testXxxはPHPUnitのtest対象になるので。
	[[Category:PHP]]		[[Category:PHP]]