RのWeb制作

Webサービス制作のための技術情報を。

Web制作

PHPのコーディング規則、PSRを学ぶ(5)

投稿日:

PHPのコーディング規則、PSRを学ぶ(4)の続きです。
この記事では、PHPのコーディング規則PSRの規則をまとめます。

1.規則概要

  1. 文字コードはUTF-8(BOM無し)
  2. 改行コードはLF
  3. PHP(開始)コードは「<?php」または 「<?=」
  4. PHPのみのファイルの場合は最後の「?>」を省略してよい
  5. 最後は改行して終わる
  6. インデント(字下げ)は「半角スペース4つ」でタブを使わない
  7. 開き「{」は改行して記述
  8. シンボル(クラス、関数、定数など)を宣言するためのファイルと、副作用のある処理(出力の生成、ini設定の変更など)を行うためのファイルは、分けるべき
  9. クラス名は、StudlyCaps(単語の先頭文字を大文字で表記する記法)記法で定義
  10. メソッド名はcamelCase(単語の先頭文字を大文字で表記するが、最初の1文字目は小文字とする記法)記法で定義
  11. クラス定数(const)は全て大文字とし、区切り文字にはアンダースコアを用いて定義
  12. 名前空間定義・use定義のあとには空行を挟む
  13. プロパティの命名規則は「StudlyCaps」「camelCase」「under_score」どれでもよいがファイル内で一貫させること
  14. PHPの予約語は小文字で使用
  15. PHP定数であるtrue、false、nullは小文字で使用
<?php
namespace Vendor\Package;

use FooInterface;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;

class Foo extends Bar implements FooInterface
{
    public function sampleFunction($a, $b = null)
    {
        if ($a === $b) {
            bar();
        } elseif ($a > $b) {
            $foo->bar($arg1);
        } else {
            BazClass::bar($arg2, $arg3);
        }
    }

    final public static function bar()
    {
        // メソッド本文
    }
}

2.名前空間とオートローダーについて

  1. PHP5.3.0以上が必要
  2. (namespaceを利用するためです。オートローダーを使わない場合は問題ありません。オートローダーについてはPSR-0(日本語)をご覧ください。)

  3. 名前空間は「\<ベンダー名>\(<名前空間>\)*<クラス名>」と設定すること。
  4. 言い換えると、「\製作者名\(機構名)\機能名」と設定して名前空間を汚染しないようにしてください。

  5. クラス名のアンダースコア「_」はディレクトリの区切りになる
  6. 名前空間の中のアンダースコア「_」はディレクトリの区切りにはならない

初心者の方の目線で見た名前空間は、PHPのコーディング規則、PSRを学ぶ(3)にまとめています。

最後に

サイトの改修が完了しましたにいただいたコメントをヒントに「PHPのコーディング規則、PSRを学ぶ」が始まりました。コメントありがとうございました。

参考にさせていただいたサイトの運営者の方々、ありがとうございました。すごく勉強になりました。

PHP・CGIプログラムは使われてこそ価値があります。PHPプログラムを配布し始めたのは最近ですが、それを誰もが改修出来るようにすることによって、さらに良いものが生まれてくることを願っています。

「面白い(個人制作の)ゲームをやりたい!」「いいプログラムを使いたい!」からこそやっております。もし面白いと感じるゲームや便利なプログラムがあったらコメントなどで紹介してください。( ^^)

各記事へのリンク

  1. PHPのコーディング規則、PSRを学ぶ(1)
  2. PHPのコーディング規則、PSRを学ぶ(2)
  3. PHPのコーディング規則、PSRを学ぶ(3)
  4. PHPのコーディング規則、PSRを学ぶ(4)
  5. PHPのコーディング規則、PSRを学ぶ(5)(当記事)

参考

-Web制作

執筆者:


  1. […] 次は、「PSRの規則をまとめてみる」を行います。 PHPのコーディング規則、PSRを学ぶ(5)へ […]

comment

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

関連記事

機械学習の勉強から見えた「間違いだらけのAI認識」

「AI」という字面が新聞にもネットニュースにも数多く出てくるようになりました。 ただ、機械学習を勉強してて思ったんですが・・・・AIの定義が曖昧すぎる 内容が書いてある記事も殆ど無いし…。 AIが行っ …

no image

まとめ読み バージョン1.1.1のリリース

フリーソフト「まとめ読み」バージョン1.1.1のリリースを行いました。 まとめ読み ダウンロードページ 変更点 検索方法の変更 検索マッチングの先を、「タイトル&内容」「内容」の2つに変更しました。 …

no image

[PHP]PDO、2つ以上の項目からLIKE検索

データベースからPDOを使ってデータを抜き出したい! そして「bindParam」で安全に検索しよう。そうしよう。 しかし、見事にハマりました。/(^o^)\ 解決方法はこちら! $pdo = new …

no image

[PHP]まとめ読みをPSRで改良する(1)

今回の改良対象 → ミニ四駆まとめサイト なぜやるのか? PHPのバージョンアップによる速度の向上 一番はこれでしょう。 今のはPHP5.2で動いています。 1割から5割の速度向上が見込まれます。 1 …

[Meisyo]スマホ表示の改良

「スマホ版使いにくすぎ」と知人に言われたので、スマホ表示の改良を行いました。 Android版 iPhone版 改良内容は、「ボタン化」が大きいですねー。 わりと使いやすくなったのか・・・?