Можем ли мы иметь статические типы в PHP без PHP 7 или HHVM?

 ini_set("augmented_types.enforce_by_default",1);

Или непосредственно в файле конфигурации php.ini Обязательно ознакомьтесь с документацией для получения более подробной информации о процессе установки.

использование

Ранее мы упоминали, что расширение использует phpDoc для прототипов функций / методов. Большая часть его функциональности может быть объяснена с помощью примеров кода.

 /**
 * Add one
 *
 * @param   int $a
 * @return    int
 */
function plusone($a)
{
    return $a + 1;
}

var_dump(plusone(1));
var_dump(plusone("1"));
var_dump(plusone("1 apple"));

Вы можете подумать, что сможете угадать вывод приведенного выше кода, но вы, вероятно, ошибаетесь!

 int(2)
PHP Fatal error:  Wrong type encountered for argument 1 of function plusone, was expecting a integer but got a (string) '1' in /vagrant/test_at/test.php on line 15

Даже второй звонок не проходит! Это происходит потому, что мы не выполняем преобразование PHP, о котором мы говорили ранее, функция требует от нас строго передавать целое число. А как насчет того, чтобы вызывать его с помощью float?

 var_dump(plusone(1.5));

 PHP Fatal error:  Wrong type encountered for argument 1 of function plusone, was expecting a integer but got a (float) 1.500000 in /vagrant/test_at/test.php on line 14

Мы заставили нашу функцию принимать два типа аргументов (int и float), используя определение составных типов .

 /**
 * Add one
 *
 * @param   int|float $a
 * @return    int
 */
function plusone($a)
{
    return $a + 1;
}

var_dump(plusone(1));
var_dump(plusone(1.5));

Теперь наша функция должна работать как положено.

 int(2)
PHP Fatal error:  Wrong type returned by function plusone, was expecting a integer but got a (float) 2.500000 in /vagrant/test_at/test.php on line 0

К сожалению! Мы также должны определить тип возвращаемого значения для нашей функции или привести приведенное значение в соответствие с phpDoc.

 /**
 * Add one
 *
 * @param   int|float $a
 * @return    int|float
 */
function plusone($a)
{
    return $a + 1;
}

Мы также можем работать с составными типами: в следующем примере суммируются элементы массива.

 /**
 * Calculate sum
 *
 * @param   array $nums
 * @return    int
 */
function sum($nums)
{
    $sum = 0;
    foreach ($nums as $value) {
        $sum += $value;
    }

    return $sum;
}

var_dump(sum([10, 12, 76]));

// output
int(98)

Функция возвращает ожидаемое значение. Что если массив содержит что-то кроме целых чисел?

 var_dump(sum([10, 12, "something"]));

// output
int(22)

Расширение дает нам возможность работать с типами массивов . Предыдущий пример выдаст фатальную ошибку, как и ожидалось.

 /**
 * Calculate sum
 *
 * @param   int[] $nums
 * @return    int
 */
function sum($nums)
{
    $sum = 0;
    foreach ($nums as $value) {
        $sum += $value;
    }

    return $sum;
}

var_dump(sum([10, 12, 76]));
var_dump(sum([10, 12, "something"]));

 int(98)
PHP Fatal error:  Wrong type encountered for argument 1 of function sum, was expecting a (integer)[] but got a array in /vagrant/test_at/test.php on line 20

Интересный случай, когда у нас есть функция, которая принимает произвольное количество аргументов. Мы можем заставить нашу предыдущую функцию возвращать сумму всех переданных аргументов.

 /**
 * Calculate sum
 *
 * @param   *int $nums
 * @return    int
 */
function sum($nums)
{
    $args = func_get_args();
    $sum = 0;
    foreach ($args as $value) {
        $sum += $value;
    }

    return $sum;
}

var_dump(sum(10, 12, 76));

Определение типа *int Мы можем объединить определения типов *intint[]

 /**
 * Calculate sum
 *
 * @param   *int|int[] $nums
 * @return    int
 */
function sum($nums)
{
    if ( !is_array($nums) )
    {
        $nums = func_get_args();
    }

    $sum = 0;
    foreach ($nums as $value) {
        $sum += $value;
    }

    return $sum;
}

var_dump(sum(10, 12, 76));
var_dump(sum([10, 12, 76]));

Теперь оба вызова функций вернут одно и то же значение ( int(98)

 /**
 * SSH to server.
 *
 * @param   string      $url
 * @param   int|void    $port
 * @return  bool
 */
function ssh($url, $port = 2222)
{
    return true;
}

 class User
{
    protected $id;

    protected $name;

    /**
     * Constructor
     * @param int       $id
     * @param string    $name
     * @return void
     */
    public function __construct($id, $name)
    {
        $this->id = $id;
        $this->name = $name;
    }

    /**
     * Return the user info as a string.
     *
     * @return    string
     */
    public function __toString()
    {
        return $this->name;
    }
}

 augmented_types_blacklist([__DIR__."/vendor"]);

 augmented_types_whitelist([__DIR__."/vendor/mylib"]);

 # php.ini
augmented_types.whitelist=./vendor
augmented_types.blacklist=./vendor/mylib