I`m PHPer!!!!!

便利なstatic

PHPの static メソッドは、インスタンスを生成せずにクラスから直接呼び出せるメソッドです。

使うべきタイミング

状態を持たない処理

インスタンスの状態に依存しない、独立した処理を行う場合に適しています。例えば、ユーティリティ関数やヘルパー関数などがこれに該当します。

class MathHelper {
  public static function add($a, $b) {
    return $a + $b;
  }
}

echo MathHelper::add(3, 4); // 出力: 7

ファクトリーメソッド

クラスのインスタンスを生成するメソッド（ファクトリーメソッド）として使用されることがあります。

この場合、`new`キーワードを隠蔽して、インスタンス化の過程を制御できます。

class User {
  public $name;

  private function __construct($name) {
    $this->name = $name;
  }

  public static function create($name) {
    return new self($name);
  }
}

$user = User::create('John Doe');

あまり使いたくないね。。。

シングルトンパターン

特定のクラスのインスタンスが一つだけ存在することを保証するシングルトンパターンの実装に利用されます。

<?php

class Singleton
{
    private static $instance;

    private function __construct()
    {
// プライベートコンストラクタ
    }

    public static function getInstance()
    {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
}

$singleton = Singleton::getInstance();

だめな使い方

インスタンスの状態を操作する処理

インスタンスの状態に依存するメソッドに`static`を使うべきではありません。staticメソッドはクラスレベルで動作するため、インスタンス固有の状態を保持することができません。

class User {
  private $name;

  public static function setName($name) {
    $this->name = $name; // エラー: $thisを使えない
  }
}

過度な使用

全てのメソッドを`static`にすることは避けるべきです。

staticメソッドを多用すると、オブジェクト指向プログラミングの基本原則であるカプセル化や多態性が損なわれる可能性があります。
特に、後からメソッドをオーバーライドする必要が出てきた場合に柔軟性を失います。

依存性注入の回避

staticメソッドは依存性注入と相性が悪く、テストやメンテナンスが難しくなる場合があります。テスト可能なコードを維持するためには、インスタンスメソッドを使用し、必要な依存関係をコンストラクタやセッターで注入する方が望ましいです。

まとめ

static メソッドは、クラス固有の処理やユーティリティ関数として適切に使用することで、コードの構造を明確にし、インスタンス化を不要にするメリットがあります。ただし、過度な使用はオブジェクト指向の原則を損なう可能性があるため、状況に応じて適切に使い分けることが重要です。

Interfaceは、コードの可読性や保守性を向上させる強力なツールです。

この記事では、僕がInterfaceを使う理由とその利点について、具体例を交えながら説明します。

コードの一貫性を保つ

Interfaceを使うことで、プロジェクト全体で一貫したメソッドシグネチャを保つことができます。例えば、複数のクラスが同じ操作を実行する場合、それぞれのクラスに同じメソッドを実装させることが可能です。これにより、コードを読む際にメソッドの名前や引数の形式に迷うことがなくなります。

interface LoggerInterface {
  public function log(string $message): void;
}

class FileLogger implements LoggerInterface {
  public function log(string $message): void {
    // ファイルにログを記録する処理
  }
}

class DatabaseLogger implements LoggerInterface {
  public function log(string $message): void {
    // データベースにログを記録する処理
  }
}

依存関係の注入を容易にする

Interfaceを使うことで、依存関係の注入が容易になります。

特定のクラスに依存するのではなく、Interfaceに依存することで、将来的にクラスを変更する場合でも、コード全体に大きな影響を与えずに済みます。

class UserController {
  private $logger;

  public function __construct(LoggerInterface $logger) {
    $this->logger = $logger;
  }

  public function createUser(string $name): void {
    // ユーザー作成の処理
    $this->logger->log("User created: $name");
  }
}

テストの容易化

Interfaceを使用することで、テストが容易になります。
モックオブジェクトやスタブを使って、依存関係を簡単に置き換えることができるため、ユニットテストの実行が簡単になります。

モックができないとUTが書きづらい場面が多々出てくるので、そのためだけに Interface を使っていると言っても過言ではないです。

class MockLogger implements LoggerInterface {
  public function log(string $message): void {
    // テスト用のモック処理
  }
}

$logger = new MockLogger();
$controller = new UserController($logger);
$controller->createUser('John Doe');
// ここでログが正しく動作するかをテスト

拡張性の向上

Interfaceを使うことで、新しい機能の追加が容易になります。

例えば、新しいタイプのLoggerを追加する場合、既存のコードを変更することなく、新しいクラスを追加するだけで済みます。

class EmailLogger implements LoggerInterface {
  public function log(string $message): void {
    // メールにログを送信する処理
  }
}

まとめ

Interfaceを使うことで、コードの一貫性、依存関係の管理、テストの容易化、拡張性の向上といった多くの利点があります。PHPでの開発において、Interfaceを効果的に活用することで、より健全で保守性の高いコードを実現することができます。ぜひ、皆さんもInterfaceの利点を活用してみてください。

都内で三流プログラマーとして働いているやんやんです。

世界一流エンジニアの思考法 を自分の中に落とし込む記事を書いています。

本書の紹介

世界一流エンジニアの思考法 (文春e-book)

一流との違い

試行錯誤は悪

分かるようになるまで自分でどうにかする もしくは 質問できるレベルになるまで自分で調べる という形で取り組んできた自分からするとかなり衝撃的だった。

本書では、その試行錯誤の時間は正解を探しているだけで何も新しい知識を学んでいないとなかなかのパンチラインを残している。

何も学んでいない = 次の問題がやってきたときに対処ができないということになるのだろう。

確かにその通りだ。

ログから手当たり次第に試すのではなく、このログがどこでどのように吐かれたのか、依存関係や背景を基に何が原因か考えることができるようになりたい。 ← 凄く難しくないか？

理解に時間をかける

これは日々痛感しているのだが、仕事のできる上司はかなり理解力が高く、コミュニケーションを取ることに対して引け目を感じていた。

本書では、どんなに能力が高い人でも理解に時間がかかることを説明していた。

僕の上司も「今までに〇〇をXXしてきたから」「これはあの時に苦しんだから」と時間なり、それ相応の苦労をしてきたと言っていた。

本書ではビッグテックの現場で出ている体験を基にしているので、世界レベルのエンジニアでも理解することに対して時間がかかるのだろう。

これまでの積み重ねで皆頑張っているんだと何故か共感できた。

小さなドキュメントをコードの前に書く

これは技術レベルに関係なく、すぐ実践できることなので今日から実践していきたい。

今から何を作るのか理解するために小さなドキュメントを書いていく。

• Scope
• Background
• Problem
• Solution

確か、岡田斗司夫も同じようなことを言っていた。

マインドセット

BeLazy

BeLazy = 怠惰 という意味になるが、そのままの意味ではなく、「少ない時間で価値を最大化しなさい」という教えがあった。（プログラマの三大美徳の怠惰と同様の考え方。

これを達成するためが以下のことだと考える。

• やるべきことを絞る
• それ以外はやらない

やるべきことを達成したら、またやるべきことを絞り、、、というサイクルを回して価値を最大化していく。

ビジネスマンである限り、ここで言われていることは目指すべきではあるがそう簡単ではないというのが現実である。

それでも言っていることは正しいと思うので近づけるよう努力したい。

リスクや間違いを受け入れる

これは下記記事の時にいた上層部に届いてほしい。

この当時の会社では案件を頓挫させてしまったが最後、席を追い出される形で最終的に退職することになった。

[getpost id=”1204″ target=”_blank” cat_name=”1″ date=”0″]

話を戻す。

成功へ早く近づくために、失敗を受け入れるマインドを持つ必要がある。

• 早く失敗する
• 失敗から学ぶ

まずはやってみて、そこから学んで次へ進んでいくようにしたい。

事の発端

副業案件を獲得するためにいくつかの面談を受けている際に面接官に言われた一言です。

いやぁ〜、恐ろしい。

要件次第で色が違ってくるのがシステム開発というもののハズですが、仕事という観点で見た際にPHPで作るシステムは簡単に作れるという考えを持っている人がいました。

なぜ、こうもPHPの立ち位置が低いのか僕なりに考えてみました。

（そもそも「PHPで作ればシステム開発は楽になる」という考え方事態がおかしいのですが。。

PHPが舐められている原因

駆け出しが増えすぎた

PHPの業界内の立ち位置として駆け出しエンジニアが選択するファースト言語という特色があります。
（かくいう僕も初めて選択した言語はPHPでした）

駆け出しエンジニアに選択されやすいという特色が故、ロースキルのプログラマが大量生産され、業界内での評価がガタ落ちしたのではないでしょうか。

また、2020年〜2023年の間にインフルエンサー達によるフリーランスの布教活動の波も影響していると思います。

仕事を発注する側から見た場合、経験年数が短く、「PHPできます」という人に対して不信感を抱くのも当然かもしれません。

自由にかけてしまう

PHPの特性について、コードの型を指定せずに書くことができる柔軟性があります。

これは素早くコードを記述できる利点を持つ反面、実行時にエラーが発生する可能性が高まります。
この特性は、プログラムを実行するまでエラーが検知されないため、デバッグや修正が手間取ることがあります。

この柔軟性から「動くものは簡単に作れる」というイメージが生まれ、結果として経験豊富な開発者からはPHPが好まれない傾向にあります。
一部のエンジニアは、この柔軟性が多くのインシデントやバグを引き起こす原因と見なしていることもあります。（僕の上司もPHPの言語仕様が嫌いです。笑）

特にセキュリティや安定性が求められる場面では、この特性がリスクとなることがあります。

過去にインシデントが多数報告

実際にPHPコードの柔軟性が原因でセキュリティ上の問題や重大なエラーが発生した事例が多く報告されています。

CVEデータベースを見てみてください。PHPの報告が多数上がっていますよ。

PHPに限らずインシデントの内容をチェックすると勉強にもなるので一度見に行ってみるのをオススメします〜

じゃあPHPerはどうするの？

正しいPHPを学ぶ

PHPの最新の機能や改善点を把握し、セキュアで効率的なコーディングを心掛ける必要があります。（エンジニアなら当たり前だろ！ってマサカリ飛んできそうですが笑）

かくいう僕もPHP8でリリースされたmatch式を知らなかった過去があります。しっかり学びましょう笑

また、静的型付け言語ほど厳格な型指定はできないのですが、PHPの型システムを利用したセキュアコーディングやジェネレータを使用してメモリの過消費を防ぐコーディングを意識する必要があります。

PHP以外にもスキル身に付ける

新卒が優秀になってきていることやChatGPTの登場など、PHPだけができる人は本当に不要になってきているのを肌で感じます。

そのため、以下のどちらかに裾のを広げていく必要があると思います。

• PHP + フロント(React or Vue + TS)
• PHP + インフラ

僕はフロントがあまり得意ではないのでインフラ周りを勉強中です。

fa-adnPHP以外を身につけると

PHP以外を身につけると明らかに単価がアップします。
例えば、PHP + AWS のような案件や PHP + React + TypeScript の案件に携われる可能性が出てきます。
PHPの枠を出ることによって確実に世界が広がるのでおすすめです。

PHPは素晴らしい言語だぞ

近年のPHPは、安全性や効率性の向上に焦点を当てて進化しています。

例えば、PHP 8や8.1のリリースでは、型付きプロパティや名前付き引数など、新機能が追加されました。
PHP8.2ではreadonly classがリリースされています。
これにより、コードの品質向上やエラーハンドリングの改善が実現しました。

そして何よりもPHPは数多くのシステム開発の実績を持っています。
2023年においてちらほら「PHPはレガシーだ」という意見が出てきていますが、今も現役に稼働しているシステムが多数あります。

過去の先輩PHPer 達が遺してくれた数多くの仕事がまだまだ残っています。そしてこれからもまだまだ増えていくでしょう。

何かと批判されがちなPHPですが、世の中に価値を届けることができる可能性に満ちた言語です。

正しい知識と幅広い知識を持ち合わせたPHPerになっていきましょう〜

配列やオブジェクトの要素を展開するための構文です。

この構文は、配列やオブジェクトをより簡潔かつ柔軟に操作するために使用されます。

スプレッド構文を使用すると、配列やオブジェクトの要素を取り出して、別の配列やオブジェクトに組み込むことができます。
配列の場合、要素を展開して別の配列に組み込むことができます。オブジェクトの場合、プロパティを展開して別のオブジェクトに組み込むことができます。

$test = [1, 2, 3];
$testUnion = [...$test, 4, 5, 6];

var_dump($testUnion); 
// [1, 2, 3, 4, 5, 6]

$test = ['name' => 'tarou', 'age' => 30];
$testUnion = ['city' => 'Gifu', ...$person1];

var_dump($testUnion); 
// ['city' => 'Gifu', 'name' => 'tarou', 'age' => 30]

使い所

複数の配列を結合したり、オブジェクトのプロパティを組み合わせたりする場合

$test1 = [1, 2, 3];
$test2 = [4, 5, 6];
$testUniion = [...$numbers1, ...$numbers2];

var_dump($testUnion); 
// [1, 2, 3, 4, 5, 6]

※array_merge()とやっていることは一緒。
なので、基本的にarray_merge()を使用することは今後少なそう。

配列やオブジェクトの一部の要素を変更する場合

$original = [1, 2, 3, 4, 5];
$modified = [...array_slice($original, 0, 2), 6, ...array_slice($original, 3)];

var_dump($modified); 
//展開
array(5) {
[0]=>
int(1)
[1]=>
int(2)
[2]=>
int(6)
[3]=>
int(4)
[4]=>
int(5)
}

関数の引数として使用する場合

function sum(...$numbers) {
  return array_sum($numbers);
}

$result = sum(1, 2, 3, 4, 5);

var_dump($result); 
//int(15)

※シンプルに配列を渡せばいいのではないか？と思ったのですが、呼び出し元で渡している引数が無限に増えても対応できるので結構便利かもしれません。

配列やオブジェクトのコピーを作成する場合

$original = [1, 2, 3];
$copy = [...$original];

var_dump($copy); 
// [1, 2, 3]

思う所

JSを使うPJならつかっても良いかな…？

ES2015からJSでもスプレッド構文が出現しているとのことです。
https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/Spread_syntax

一応PHPの方が先に機能として発表しているのですが、何と言ってもJS様です。

JS様と統一性を持って記述ができるのが魅力かもしれませんね…

これまでにforeachを使用して配列を任意の形に加工していた。

ところがどっこい、PHPには便利な関数が存在することを最近知った。

これまで配列から1つずつ要素を取り出し、所定の処理を実行していた自分が恥ずかしい…

array_map

配列の各要素に所定の処理を行う関数。（結構よく使うようになった。だって便利だもん）

ぼかぁ、CSVを読み込んだ後に文字コードの変換等を行うときに結構使用する。

array_map(コールバック関数, 配列)

$test =['ジョーダン', 'ジョンソン', 'ジャクソン'];

$testMap = array_map(function($t) {
    return 'マイケル' . $t;
}, $test);

var_dump($testMap);
array(3) {
[0]=>
string(27) "マイケルジョーダン"
[1]=>
string(27) "マイケルジョンソン"
[2]=>
string(27) "マイケルジャクソン"
}

連想配列を指定すると多次元配列として返ってくるのでそこだけは要注意。

$test =['ジョーダン', 'ジョンソン', 'ジャクソン']; 
$testMap = array_map(function($t) {
    return ["test" => 'マイケル' . $t]; 
}, $test);
var_dump($testMap);

array(3) {
  [0]=>
  array(1) {
    ["test"]=>
    string(27) "マイケルジョーダン"
  }
  [1]=>
  array(1) {
    ["test"]=>
    string(27) "マイケルジョンソン"
  }
  [2]=>
  array(1) {
    ["test"]=>
    string(27) "マイケルジャクソン"
  }
}

array_filter

名前の通りフィルタリングしてくれるっす。基本的にはarray_map()と一緒です。

ただし内部的にはempty()が実行されているようなので、配列から空を除去できるらしい。(いつ使うのか想像できないけれど、)

$test =['ジョーダン', '', 'ジャクソン'];

$testFilter = array_filter($test);

var_dump($testFilter);

array(2) {
  [0]=>
  string(15) "ジョーダン"
  [2]=>
  string(15) "ジャクソン"
}

array_reduce

配列の要素を1つの値に加工してくれる関数。

チェックボックス等で指定された検索条件（配列）をSQLの条件式に割り当てるときに使用できる。

今回は生SQLに無理やり割り当てているが、ORMの場合は結構使いやすい。

$test =['1', '2', '3']; 

$query = '1=1';
$testFilter = array_reduce($test,  function($carry,$item) {
	$carry = $carry . ' OR test_column = '. $item;
	return $carry;	
}, $query);

var_dump($testFilter);
string(60) "1=1 OR test_column = 1 OR test_column = 2 OR test_column = 3"

array_reduce()に渡している要素がなくなるまで、以下の処理が繰り返される。

1. $testのインデックスが0の値を抽出し、クロージャの$itemに格納し処理をする。
2. 1つの処理が終了すると$carryに値を保持する
3. 最後に$carryを返却

ちなみにarray_reduce()の第三引数に一番最初に処理を実行する前の初期データ$queryを渡しているが、省略することができる。

<?php
$test =['1', '2', '3']; 

$testFilter = array_reduce($test,  function($carry,$item) {
	$carry = $carry . ' OR test_column = '. $item;
	return $carry;	
});

var_dump($testFilter);
string(57) " OR test_column = 1 OR test_column = 2 OR test_column = 3"
?>

先に結論なんですけど、リーダブルコードは当たり前の事が書いてあります。

ただその当たり前の事が出来ていないと感じたのですぐに実践できることを備忘録として残したいと思います。

プログラマーとして

forのネスト

ループがネストしている場合はインデックスを分かりやすく定義してあげる。

以下のコードではループする変数の接頭辞をインデックスの接頭辞に着けることで、インデックスの使用を楽に出来る！！
※めちゃくちゃ便利！わかりやすい！
※ループをネストしないコードをかければ一番良いかもねぇ

$users = array(
    //複数要素
);

$entry_point = array(
    //複数要素
);

for($u_i=0;$i<count($users);$u_i<$users){
    for($e_i=0;$e_i<count($entry_point);$e_i<$entry_point){
        //処理
    }
}

視覚的に優しく

縦に並べる

DB::table('ex_stores')->insert([
            [
                'store_id' 　　　　　　　　　　　　=> '123456',
                'logo_path' 　　　　　　　　　　=> 'demo_cafe.png',
                'big_category' 　　　　=> '食べ物',
                'small_category' => 'カフェ',
                'tag1' 　　　　　　　　　　　　　　　　　　　　=> 'ゆったり',
                'tag2' 　　　　　　　　　　　　　　　　　　　　=> 'まったり',
                'tag3' 　　　　　　　　　　　　　　　　　　　　=> '潮風に揺られながら',
                'top_url' 　　　　　　　　　　　　　　=> 'main',
            ]
]);

コメント

コードに指摘を入れる場合

自分が書いたにしろ他人が書いたにしろ、何かを感じた場合は下記のようにコメント残したいです。

特にGitのコメントに使えそう。

コメントの基本原則として以下を抑えておきたい。

クラスやメソッドはひと目で分かるように

クラスやメソッド内での処理がすぐに理解できるように、処理内容をコメントする。

パターンとしては以下がある。

• 実例をコメント
  • • XXXを○○○して△△△という形式に変更
• 処理をブロックごとに分けてコメントする
  • • 大きいメソッドなどは適切なタイミングでコメント

問題になりそうな箇所は先に明示する

※かなり大事な気がするので例を書きます。

仮にインサート関数とデリート関数を定義してインサート関数の前にデリート関数を実行させる処理を行いたいとする。

class DB{
public function insert($data){
DB::delete();   
}

public function delete(){

}

}

インサート関数の中でデリート関数を呼び出しているのですが、仮にデリート関数で複雑な処理を行っており処理自体が10秒かかるとしたらインサート処理自体が10秒以上かかってしまうことになります。

上記の場合、詳細を知らないメンバーがデリート関数を呼び出してしまうと想定外の結果となってしまう危険性があるため、以下のようなコメントを残す必要があります。

class DB{
public function insert($data){
DB::delete();   
}

//注意：実行時間10秒以上
public function delete(){

}

}