Co nowego w PHP v7.3? Opisaliśmy wszystkie 34 zmiany

13 grudnia zostanie udostępniona wersja produkcyjna PHP v7.3. Zmian jest naprawdę dużo, choć nie są rewolucyjne. Większość z nich to drobnostki, ale na pewno każdy znajdzie coś dla siebie. Wszystkie 34 aktualizacje postanowiłem opisać poniżej.

Damian Dziaduch. Absolwent Uniwersytetu Gdańskiego. Zawodowy programista z 7 letnim stażem. Aktualnie lider zespołu oraz specjalista od wydajności w GForces Polska. Po godzinach bloger (damian.dziaduch.pl) i freelancer. Lubi czysty kod, testowanie, wydajność, a także produktywność.

Spis treści

1. Elastyczna składnia HEREDOC / NOWDOC

Znacznik zamykający – nowa linia

Do tej pory, po znaku zamykającym wyrażenie, wymagana była nowa linia:

sql_quote(<<<STR
select *
from table
where 1=1;
STR
);
 
$data = [<<<DATA
a
b
c
DATA
, 'd e f'];

sql_quote(<<<STR

select *

from table

where 1=1;

STR

);

$data = [<<<DATA

DATA

, 'd e f'];

W nowej wersji nie ma już tego wymogu:

sql_quote(<<<STR
select *
from table
where 1=1;
STR);
 
$data = [<<<DATA
a
b
c
DATA, 'd e f'];

sql_quote(<<<STR

select *

from table

where 1=1;

STR);

$data = [<<<DATA

DATA, 'd e f'];

Wcięcie znacznika zamykającego

W aktualnej wersji PHP znacznik zamykający musi być na początku linii:

class Foo {
    private const SQL = <<<SQL
select *
from table
where 1=1;
SQL;
}

class Foo {

private const SQL = <<<SQL

select *

from table

where 1=1;

SQL;

}

W nowej wersji całe wyrażenie HEREDOC / NOWDOC może być wcięte:

class Foo {
    private const SQL = <<<SQL
    select *
    from table
    where 1=1;
    SQL;
}

class Foo {

private const SQL = <<<SQL

select *

from table

where 1=1;

SQL;

}

Co ważne, wcięcie znacznika zamykającego decyduje o ilości usuniętych białych znaków z łańcucha znaków:

// bez wcięcia znacznika zamykającego
echo <<<END
      a
     b
    c
END;
/*
      a
     b
    c
*/
 
// wcięcie na 4 spacje
echo <<<END
      a
     b
    c
    END;
/*
  a
 b
c
*/

// bez wcięcia znacznika zamykającego

echo <<<END

END;

// wcięcie na 4 spacje

echo <<<END

END;

Ja jestem bardzo zadowolony z tych zmian, często używam HEREDOC / NOWDOC np. do budowania zapytań SQL.

Uwaga na składnie nie kompatybilne z nową wersją

Jeśli w starym kodzie masz znacznik zamykający wewnątrz łańcucha znaków, może to spowodować błąd lub łańcuch zostanie źle zinterpretowany. W poniższym kodzie zostanie wyrzucony ParseError:

$str = <<<FOO
abcdefg
    FOO
FOO;
var_dump($str);
// Parse error: Invalid body indentation level (expecting an indentation level of at least 4) in test.php on l

$str = <<<FOO

abcdefg

FOO

FOO;

var_dump($str);

// Parse error: Invalid body indentation level (expecting an indentation level of at least 4) in test.php on l

Przy tej zmianie radzę zweryfikować czy stary kod działa poprawnie. Polecam do tego Unit Testy.

Więcej w RFC: https://wiki.php.net/rfc/flexible_heredoc_nowdoc_syntaxes.

2. Przecinek po ostatnim argumencie w wywołaniach funkcji / metod

Aktualnie możemy zostawić przecinek po ostatnim elemencie w tablicy oraz w grupowanych namespace. W nowej wersji możemy przecinek zostawić po ostatnim argumencie w wywołaniach:

ZOBACZ TEŻ: Pójdziemy na L4, jeśli czujemy wypalenie zawodowe. Zmiany od przyszłego roku

unset(
    $foo,
    $bar,
    $baz,
);
 
echo $this->render(
    'index.html',
    compact(
        'title',
        'body',
        'comments',
    )
);
 
$newArray = array_merge(
    $arrayOne,
    $arrayTwo,
    [
        'foo',
        'bar'
    ],
);
 
$closure = function () {};
$closure(
    1,
    false,
);

unset(

$foo,

$bar,

$baz,

);

echo $this->render(

'index.html',

compact(

'title',

'body',

'comments',

)

);

$newArray = array_merge(

$arrayOne,

$arrayTwo,

[

'foo',

'bar'

);

$closure = function () {};

$closure(

false,

);

Co ważne, dotyczy to tylko wywołań a nie deklaracji!

Jeśli dbasz o ładną historię w systemie kontroli wersji, to na pewno będziesz zadowolony.

Więcej informacji:

3. Wsparcie referencji w list()

Używając operatora list() nie mogłeś użyć referencji. Teraz jest to możliwe:

$array = [1, 2];
list($c, &$d) = $array;
[$a, &$b] = $array;<br>

$array = [1, 2];

list($c, &$d) = $array;

[$a, &$b] = $array;<br>

Kod jest poprawny i działa jak należy w v7.3.

Więcej informacji:

4. `json_encode()` i `json_decode()` – rzucanie wyjątków

Gdy wywołasz json_decode() z niepoprawnym JSON funkcja zwróci null. Co ciekawe, gdy wywołasz ją z poprawnym JSON, który zawiera tylko null, funkcja również zwróci null. Jedyną metodą, by sprawdzić czy wystąpił błąd podczas dekodowania jest odwołanie się do funkcji json_last_error() lub json_last_error_msg().

W v7.3 to się zmieni. Ekipa PHP wprowadziła flagę JSON_THROW_ON_ERROR, dzięki której funkcja json_encode() oraz json_decode() będą rzucać wyjątek JsonException, gdy coś pójdzie nie tak. Co ważne, kod wyjątku będzie zgodny z kodem zwracanym przez funkcję json_last_error(), a wiadomość zgodna z wiadomością zwracaną przez json_last_error_msg().

try {
    $decoded = json_decode("{ 'invalid' : 'json' }", false, 512, JSON_THROW_ON_ERROR);
} catch (\JsonException $e) {
    echo $e->getCode(); // 4
    echo $e->getMessage(); // Syntax error
}

try {

$decoded = json_decode("{ 'invalid' : 'json' }", false, 512, JSON_THROW_ON_ERROR);

} catch (\JsonException $e) {

echo $e->getCode(); // 4

echo $e->getMessage(); // Syntax error

}

Więcej informacji:

5. Nowa funkcja is_countable()

W wersji v7.2 dodano Warning które jest wyrzucany podczas próby wywołania count() na czymś co nie jest policzalne, np. na instancji stdClass. By temu zapobiec należy zweryfikować czy rzecz jest policzalna, jednak nie było do tego odpowiedniej funkcji, więc warunek jest złożony:

if (is_array($foo) || $foo instanceof Countable) {
    echo count($foo);
}

if (is_array($foo) || $foo instanceof Countable) {

echo count($foo);

}

W v7.3 wystarczy użyć is_countable():

if (is_countable($foo)) {
    echo count($foo);
}

if (is_countable($foo)) {

echo count($foo);

}

Więcej informacji:

6. Nowe funkcje `array_key/value_first/last()`

Funkcje te zostały dodane by ułatwić uzyskiwanie kluczy i wartości ostatniego i pierwszego elementu z tablicy. W v7.2 trzeba modyfikować wewnętrzny wskaźnik tablicy używając np. end() / current():

$array = [
  1 => 'a',
  5 => 'm',
  10 => 'z'
];
 
reset($array);
echo key($array); // 1;
echo current($array); // a
end($array);
echo key($array); // 10
echo current($array); // z

$array = [

1 => 'a',

5 => 'm',

10 => 'z'

];

reset($array);

echo key($array); // 1;

echo current($array); // a

end($array);

echo key($array); // 10

echo current($array); // z

W v7.3 możesz użyć dedykowanych funkcji do tego, co ważne, nie zmieniają wskaźnika wewnątrz tablicy:

$array = [
  1 => 'a',
  5 => 'm',
  10 => 'z'
];
 
echo array_key_first($array); // 1
echo array_value_first($array); // a
echo array_key_last($array); // 10
echo array_value_last($array); // z

$array = [

1 => 'a',

5 => 'm',

10 => 'z'

];

echo array_key_first($array); // 1

echo array_value_first($array); // a

echo array_key_last($array); // 10

echo array_value_last($array); // z

Więcej informacji:

7. Nowa funkcja do haszowania haseł – Argon2id

Algorytm Argon2 ma trzy odmiany:

Argon2i,
Argon2d,
Argon2id.

Ta ostatnia jest teraz zalecaną odmianą w wersji roboczej specyfikacji IEFT. W nowej wersji zostaje wsparcie poprzez funkcje password_* oraz stałą PASSWORD_ARGON2ID:

password_hash('password', PASSWORD_ARGON2ID, ['memory_cost' => 1<<17, 'time_cost' => 4, 'threads' => 2]);
 
var_dump(password_get_info('$argon2id$v=19$m=1024,t=2,p=2$ZUhOUVczSHpZRDBDU2ZBRA$k/vI1wKP4s0ecJIpUybRfgBeo3as1PhIV1Od6PvOEFA'));
 
/*
array(3) {
  ["algo"]=>
  int(3)
  ["algoName"]=>
  string(8) "argon2id"
  ["options"]=>
  array(3) {
    ["memory_cost"]=>
    int(1024)
    ["time_cost"]=>
    int(2)
    ["threads"]=>
    int(2)
  }
}
*/

password_hash('password', PASSWORD_ARGON2ID, ['memory_cost' => 1<<17, 'time_cost' => 4, 'threads' => 2]);

var_dump(password_get_info('$argon2id$v=19$m=1024,t=2,p=2$ZUhOUVczSHpZRDBDU2ZBRA$k/vI1wKP4s0ecJIpUybRfgBeo3as1PhIV1Od6PvOEFA'));

array(3) {

["algo"]=>

int(3)

["algoName"]=>

string(8) "argon2id"

["options"]=>

array(3) {

["memory_cost"]=>

int(1024)

["time_cost"]=>

int(2)

["threads"]=>

int(2)

}

Więcej informacji:

Zapraszamy do dyskusji

Cookie	Duration	Description
cookielawinfo-checkbox-necessary	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
viewed_cookie_policy	11 months	The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.

Zorganizuj jedno źródło wiedzy o pracy zespołu. Ułatwi to estymację stanu realizacji projektu

Korzystanie z Google Analytics nielegalne w Europie? Ten wyrok sądu może być przełomowy

Czy warto zostać programistą PHP w 2022 roku? Rekrutacja i zarobki

Kontakt z Redakcją. Reklama

Kodujesz za granicą? Zapraszamy do kontaktu

Co nowego w PHP v7.3? Opisaliśmy wszystkie 34 zmiany

1. Elastyczna składnia HEREDOC / NOWDOC

2. Przecinek po ostatnim argumencie w wywołaniach funkcji / metod

3. Wsparcie referencji w list()

4. `json_encode()` i `json_decode()` – rzucanie wyjątków

5. Nowa funkcja is_countable()

6. Nowe funkcje `array_key/value_first/last()`

7. Nowa funkcja do haszowania haseł – Argon2id

Patronujemy

Zorganizuj jedno źródło wiedzy o pracy zespołu. Ułatwi to estymację stanu realizacji projektu

Korzystanie z Google Analytics nielegalne w Europie? Ten wyrok sądu może być przełomowy

Czy warto zostać programistą PHP w 2022 roku? Rekrutacja i zarobki

Kontakt z Redakcją. Reklama

Kodujesz za granicą? Zapraszamy do kontaktu

Co nowego w PHP v7.3? Opisaliśmy wszystkie 34 zmiany

1. Elastyczna składnia HEREDOC / NOWDOC

2. Przecinek po ostatnim argumencie w wywołaniach funkcji / metod

3. Wsparcie referencji w list()

4. json_encode() i json_decode() – rzucanie wyjątków

5. Nowa funkcja is_countable()

6. Nowe funkcje array_key/value_first/last()

7. Nowa funkcja do haszowania haseł – Argon2id

Patronujemy

4. `json_encode()` i `json_decode()` – rzucanie wyjątków

6. Nowe funkcje `array_key/value_first/last()`