PHP Right Wayをまとめ直した。

$ echo "<?php phpinfo();" > index.php
$ php -S localhost:8000

http://localhost:8000/

$ php -i

<?php
    if ( 2 != $argc ) {
        exit(1);
    }
    $name = $argv[1];
    echo "Hello, $name\n";
?>

$ php hoge.php yuya
Hello, yuya

$ curl -s https://getcomposer.org/installer | php
$ ./composer.phar install

<?php
    require 'vendor/autoload.php';

    // 処理開始
?>

$ pear install foo

<?php
    $a = 5;   // 5はinteger型

    var_dump($a == 5);       // 値の比較。trueを返す
    var_dump($a == '5');     // 値の比較(型は無視)。trueを返す
    var_dump($a === 5);      // 型と値の比較(integer vs. integer)。trueを返す
    var_dump($a === '5');    // 型と値の比較(integer vs. string)。falseを返す

    /**
     * 厳格な比較
     */
    if (strpos('testing', 'test')) {    // 'test' は 0 番目の位置にあり、これはboolean型の'false'と見なされる
        // コード...
    }

    // vs

    if (strpos('testing', 'test') !== false) {    // 厳格な比較が行われるので、これは成立する(0 !== false)
        // コード...
}
?>

<?php
    function test($a)
    {
        if ($a) {
            return true;
        } else {
            return false;
        }
    }

    // vs

    function test($a)
    {
        if ($a) {
            return true;
        }
        return false;    // 別にelseがなくたっていいよね
    }
?>

<?php
    $answer = test(2);    // 'case 2'のコードと'case 3'のコードを両方実行する

    function test($a)
    {
        switch ($a) {
            case 1:
                // コード...
                break;             // breakでswitch文を抜ける
            case 2:
                // コード...        // breakしてないので'case 3'の評価に進む
            case 3:
                // コード...
                return $result;    // 関数の中で'return'すると、ここで関数を抜ける
            default:
                // コード...
                return $error;
        }
    }
?>

<?php
    namespace phptherightway;

    function fopen()
    {
        $file = \fopen();    // 組み込みの関数と同じ名前の関数を定義しているので、
                             // 組み込みのfopen関数を実行するには"\"を追加する
    }

    function array()
    {
        $iterator = new \ArrayIterator();    // ArrayIteratorは組み込みのクラスである。名前にバックスラッシュをつけずに使うと、
                                             // phptherightway名前空間でこの名前を探してしまう。
    }
?>

<?php
    $a  = 'Multi-line example';    // 連結代入演算子 (.=)
    $a .= "\n";
    $a .= 'of what not to do';

    // vs

    $a = 'Multi-line example'      // 連結演算子 (.)
        . "\n"                     // 改行してインデント
        . 'of what to do';
?>

<?php
    echo 'This is my string, look at how pretty it is.';    // 単純な文字列で、パースする必要がない

    /**
     * 出力は、
     *
     * This is my string, look at how pretty it is.
     */
?>

<?php
    echo 'phptherightway is ' . $adjective . '.'     // シングルクォートを使った例。複数の要素を連結し、
        . "\n"                                       // 変数の埋め込みやエスケープを使っている
        . 'I love learning' . $code . '!';

    // vs

    echo "phptherightway is $adjective.\n I love learning $code!"  // ダブルクォートを使えば、別々の要素に分けずに
                                                                   // ひとまとめにできる
?>

<?php
    $juice = 'プラム';
    echo "$juice ジュース大好き";    // 出力：プラム ジュース大好き
?>

<?php
    $juice = 'plum';
    echo "I drank some juice made of $juices";    // $juiceがパースできない

    // vs

    $juice = 'plum';
    echo "I drank some juice made of {$juice}s";    // これで、変数は$juiceだとわかる

    /**
     * 配列などの場合も波括弧で囲む
     */

    $juice = array('apple', 'orange', 'plum');
    echo "I drank some juice made of {$juice[1]}s";   // これで、$juice[1]がパースできる
?>

<?php
    $str = <<<'EOD'             // 最初は <<<
    Example of string
    spanning multiple lines
    using nowdoc syntax.
    $a does not parse.
    EOD;                        // 終了文字列はそれ単体でひとつの行に書く。また行頭に書かないといけない

    /**
     * 出力は、
     *
     * Example of string
     * spanning multiple lines
     * using nowdoc syntax.
     * $a does not parse.
     */
?>

<?php
    $a = 'Variables';

    $str = <<<EOD               // 最初は <<<
    Example of string
    spanning multiple lines
    using heredoc syntax.
    $a are parsed.
    EOD;                        // 終了文字列はそれ単体でひとつの行に書く。また行頭に書かないといけない

    /**
     * 出力は、
     *
     * Example of string
     * spanning multiple lines
     * using heredoc syntax.
     * Variables are parsed.
     */
?>

<?php
    $a = 5;
    echo ($a == 5) ? 'yay' : 'nay';
    ?>
    ```

    読みやすさを無視して、とにかく行数を減らそうとだけ考えてしまうと、こんな羽目になる。

    ```php
    <?php
    echo ($a) ? ($a == 5) ? 'yay' : 'nay' : ($b == 10) ? 'excessive' : ':(';    // やりすぎ。もはや読めない :-(
?>

<?php
    $a = 5;
    echo ($a == 5) ? return true : return false;    // この書きかただとエラーになる

    // vs

    $a = 5;
    return ($a == 5) ? 'yay' : 'nope';    // この書きかたなら 'yay' を返す
?>

<?php
    $a = 3;
    return ($a == 3) ? true : false; // $a == 3 なら true、そうでなければ false を返す

    // vs

    $a = 3;
    return $a == 3; // これでも同じこと。$a == 3 なら true、そうでなければ false を返す
?>

<?php
    $a = 3;
    return ($a == 3) ? "yay" : "nope"; // $a == 3 なら yay、そうでなければ nope を返す

    // vs

    $a = 3;
    return $a == 3 ? "yay" : "nope"; // $a == 3 なら yay、そうでなければ nope を返す
?>

<?php
    return ($a == 3 && $b == 4) && $c == 5;
?>

<?php
    return ($a != 3 && $b != 4) || $c == 5;
?>

<?php
    $about = 'A very long string of text';    // メモリを2MB消費する
    echo $about;

    // vs

    echo 'A very long string of text';        // メモリの消費は1MBだけ
?>

<?php
namespace Database;

class Database
{
    protected $adapter;

    public function __construct()
    {
        $this->adapter = new MySqlAdapter;
    }
}

class MysqlAdapter {}
?>

<?php
namespace Database;

class Database
{
    protected $adapter;

    public function __construct(MySqlAdapter $adapter)
    {
        $this->adapter = $adapter;
    }
}

class MysqlAdapter {}
?>

<?php
// PDO + MySQL
$pdo = new PDO('mysql:host=example.com;dbname=database', 'user', 'password');
$statement = $pdo->query("SELECT some\_field FROM some\_table");
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo htmlentities($row['some_field']);

// PDO + SQLite
$pdo = new PDO('sqlite:/path/db/foo.sqlite');
$statement = $pdo->query("SELECT some\_field FROM some\_table");
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo htmlentities($row['some_field']);
?>

<?php
$pdo = new PDO('sqlite:/path/db/users.db');
$pdo->query("SELECT name FROM users WHERE id = " . $_GET['id']); // <-- ダメ、ゼッタイ！
?>

<ul>
<?php
foreach ($db->query('SELECT * FROM table') as $row) {
    echo "<li>".$row['field1']." - ".$row['field1']."</li>";
}
?>
</ul>

<?php

$db = new PDO('mysql:host=localhost;dbname=testdb;charset=utf8', 'username', 'password');

// モデルを読み込む
include 'models/FooModel.php';

// インスタンスを作る
$fooList = new FooModel($db);

// ビューを表示する
include 'views/foo-list.php';

?>

<?php
class Foo()
{
    protected $db;

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

    public function getAllFoos() {
        return $this->db->query('SELECT * FROM table');
    }
}
?>

<?php foreach ($fooList as $row): ?>
    <?= $row['field1'] ?> - <?= $row['field1'] ?>
<?php endforeach ?>

<?php // template.php ?>

<html>
<head>
    <title><?=$title?></title>
</head>
<body>

<main>
    <?=$this->section('content')?>
</main>

</body>
</html>

<?php // user_profile.php ?>

<?php $this->layout('template', ['title' => 'User Profile']) ?>

<h1>User Profile</h1>
<p>Hello, <?=$this->escape($name)?></p>

$ php -a
php > echo $foo;
Notice: Undefined variable: foo in php shell code on line 1

$ python
>>> print foo
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'foo' is not defined

error_reporting(E_ERROR | E_WARNING);

echo @$foo['hoge'];

echo isset($foo['hoge']) ? $foo['hoge'] : '';

    if ( $FP = fopen() ) {
        // 処理
    }

<?php
    $email = new Fuel\Email;
    $email->subject('タイトル');
    $email->body('ごきげんいかが？');
    $email->to('guy@example.com', '誰かさん');

    try
    {
        $email->send();
    }
    catch(Fuel\Email\ValidationFailedException $e)
    {
        // 検証に失敗した
    }
    catch(Fuel\Email\SendingFailedException $e)
    {
        // ドライバがメールを送れなかった
    }
    finally
    {
        // 例外が発生してもしなくても、ここは必ず実行される
    }
?>

<?php
require 'password.php';

$passwordHash = password_hash('secret-password', PASSWORD_DEFAULT);

if (password_verify('bad-password', $passwordHash)) {
    // パスワードが一致した
} else {
    // パスワードが一致しなかった
}
?>

display_errors = On
display_startup_errors = On
error_reporting = -1
log_errors = On

display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL
log_errors = On

docker run -d --name my-php-webserver -p 8080:80 -v /path/to/your/php/files:/var/www/html/ php:apache

<?php
/**
 * @author A Name <a.name@example.com>
 * @link http://www.phpdoc.org/docs/latest/index.html
 * @package helper
 */
class DateTimeHelper
{
    /**
     * @param mixed $anything Anything that we can convert to a \DateTime object
     *
     * @return \DateTime
     * @throws \InvalidArgumentException
     */
    public function dateTimeFromAnything($anything)
    {
        $type = gettype($anything);

        switch ($type) {
            // Some code that tries to return a \DateTime object
        }

        throw new \InvalidArgumentException(
            "Failed Converting param of type '{$type}' to DateTime object"
        );
    }

    /**
     * @param mixed $date Anything that we can convert to a \DateTime object
     *
     * @return void
     */
    public function printISO8601Date($date)
    {
        echo $this->dateTimeFromAnything($date)->format('c');
    }

    /**
     * @param mixed $date Anything that we can convert to a \DateTime object
     */
    public function printRFC2822Date($date)
    {
        echo $this->dateTimeFromAnything($date)->format('r');
    }
}
?>