Alguns erros fatais e recuperáveis foram convertidos para exceções no PHP 7. Estas exceções herdam a classe Error, que implementa a interface Throwable (a interface base que todas as exceções herdam).
Isso significa que manipuladores de erros podem não ser ativados porque exceções estão sendo disparadas em seu lugar (causando novos erros fatais por exceções Error não capturadas)
Uma descrição completa de como tratar erros no PHP 7 pode ser encontrada na página de erros do PHP 7. Este guia de migração irá enumerar apenas as mudanças compatíveis com versões anteriores.
Códigos que implementam um manipulador de exceção registrado com set_exception_handler() usando a declaração de tipo Exception causará um erro fatal quando um objeto Error for lançado.
Se o manipulador precisa trabalhar com o PHP 5 e 7, você deve remover a declaração de tipo do manipulador, enquanto que o código a migrar para funcionar exclusivamente no PHP 7, pode simplesmente trocar a declaração de tipo Exception por Throwable.
<?php
// Código da era PHP 5 que não irá funcionar.
function handler(Exception $e) { ... }
set_exception_handler('handler');
// Compatível com PHP 5 e 7.
function handler($e) { ... }
// Somente PHP 7.
function handler(Throwable $e) { ... }
?>
Anteriormente, algumas classes internas retornavam NULL ou um objeto inútil
quando o construtor falhava. Todas as classes internas agora lançam
Exception neste caso, da mesma forma que
classes de usuário já faziam.
Erros de Parser agora lançam um objeto ParseError. Manipular erros da função eval() devem incluir um bloco catch que possa manipular este erro.
Todas as notificações E_STRICT foram reclassificadas para
outros níveis. A constante E_STRICT foi mantida, então chamar
error_reporting(E_ALL|E_STRICT) não causará um erro.
| Situação | Novo nível/Comportamento |
|---|---|
| Utilizar um recurso como índice | E_NOTICE |
| Métodos estáticos abstratos | Notificação removida, não dispara erro |
| "Redefinindo" um construtor | Notificação removida, não dispara erro |
| Assinatura incompatível durante a herança | E_WARNING |
| Mesmas propriedades(compatíveis) em duas traits utilizadas | Notificação removida, não dispara erro |
| Acessando propriedades estáticas de forma não estática | E_NOTICE |
| Somente variáveis devem ser ser atribuídas por referência | E_NOTICE |
| Somente variáveis devem ser passadas por referência | E_NOTICE |
| Chamando métodos não estáticos de forma estática | E_DEPRECATED |
O PHP 7 utiliza uma sintaxe abstrata de árvore para analisar os arquivos fonte. Isso permitiu diversas melhorias para a linguagem que eram impossíveis devido a limitações no analisador utilizado em versões anteriores do PHP, porém resultou na remoção de alguns casos especiais por razões de consistência, que resulta em quebras de compatibilidades com versões anteriores. Esses casos são detalhados nesta seção.
Acessar indiretamente variáveis, propriedades, e métodos, agora serão avaliados estritamente da esquerda para a direita, o oposto dos casos especiais em versões anteriores. A tabela a seguir mostra como a ordem de avaliação mudou.
| Expressão | Interpretação no PHP 5 | Interpretação no PHP 7 |
|---|---|---|
$$foo['bar']['baz']
|
${$foo['bar']['baz']}
|
($$foo)['bar']['baz']
|
$foo->$bar['baz']
|
$foo->{$bar['baz']}
|
($foo->$bar)['baz']
|
$foo->$bar['baz']()
|
$foo->{$bar['baz']}()
|
($foo->$bar)['baz']()
|
Foo::$bar['baz']()
|
Foo::{$bar['baz']}()
|
(Foo::$bar)['baz']()
|
Códigos que usam a ordem de avaliação da direita para esquerda devem ser reescritos para o uso explícito da ordem de avaliação com chaves (veja a coluna do meio). Isso fará com que o código seja compatível com versões posteriores ao PHP 7.x e compatível com o PHP 5.x.
A função list() agora irá atribuir valores as variáveis na
ordem em que foram definidas, em vez de ordem reversa. De modo geral, isso só
afeta casos onde a função list() é utilizada em
conjunção com o operador de array [], como mostrado a seguir:
<?php
list($a[], $a[], $a[]) = [1, 2, 3];
var_dump($a);
?>
O exemplo acima irá imprimir no PHP 5:
array(3) {
[0]=>
int(3)
[1]=>
int(2)
[2]=>
int(1)
}
O exemplo acima irá imprimir no PHP 7:
array(3) {
[0]=>
int(1)
[1]=>
int(2)
[2]=>
int(3)
}
De modo geral, é recomendo não confiar na ordem em que as atribuições com que a função list() ocorrem, como sua implementação detalha, isso pode mudar novamente no futuro.
Chamadas a função list() não podem mais ser vazias. O que é visto a seguir não é mais permitido:
<?php
list() = $a;
list(,,) = $a;
list($x, list(), $y) = $a;
?>
A função list() não podem mais desempacotar variáveis do tipo string. Em vez disso, a função str_split() deve ser usada.
A ordem dos elementos no array foi modificada quando estes elementos foram automaticamente criados por referenciação em uma atribuição por referência. Por exemplo:
<?php
$array = [];
$array["a"] =& $array["b"];
$array["b"] = 1;
var_dump($array);
?>
O exemplo acima irá imprimir no PHP 5:
array(2) {
["b"]=>
&int(1)
["a"]=>
&int(1)
}
O exemplo acima irá imprimir no PHP 7:
array(2) {
["a"]=>
&int(1)
["b"]=>
&int(1)
}
Variáveis Variáveis não podem mais ser utilizadas com a palavra-chave global. A sintaxe com chaves pode ser utilizada para emular o comportamento anterior, se necessário.
<?php
function f() {
// Válido somente no PHP 5.
global $$foo->bar;
// Válido no PHP 5 e 7.
global ${$foo->bar};
}
?>
Como princípio básico, usar qualquer coisa senão uma variável normal com a a palavra-chave global é desencorajado.
No PHP 5, usar parenteses redundantes em torno de parâmetros de uma função podem disparar avisos de quebra de padrões quando os parâmetros da função fossem passados por referência. Agora, o aviso sempre será emitido.
<?php
function getArray() {
return [1, 2, 3];
}
function squareArray(array &$a) {
foreach ($a as &$v) {
$v **= 2;
}
}
// Generates a warning in PHP 7.
squareArray((getArray()));
?>
O exemplo acima irá imprimir:
Notice: Only variables should be passed by reference in /tmp/test.php on line 13
Pequenas mudanças foram feitas no modo como a estrutura de controle foreach se comporta, principalmente na manipulação do ponteiro interno do array e modificações no array sendo iterado.
Antes do PHP 7, o ponteiro interno do array era modificado enquanto o array era iterado usando o foreach. Este não é mais o caso, como mostrado nos exemplos a seguir:
<?php
$array = [0, 1, 2];
foreach ($array as &$val) {
var_dump(current($array));
}
?>
O exemplo acima irá imprimir no PHP 5:
int(1) int(2) bool(false)
O exemplo acima irá imprimir no PHP 7:
int(0) int(0) int(0)
Quando usado no modo padrão, por valor, o foreach vai operar em uma cópia do array sendo iterado, ao invés do próprio array. Isso significa que mudanças feitas durante a iteração do array, não afetarão os valores iterados.
Quanto iterado por referencia, o foreach fará um melhor trabalho de controlar as alterações feitas ao array durante a iteração. Por exemplo, inclusões ao array enquanto iterado, agora resultam na inclusão de valores enquanto itera, como a seguir:
<?php
$array = [0];
foreach ($array as &$val) {
var_dump($val);
$array[1] = 1;
}
?>
O exemplo acima irá imprimir no PHP 5:
int(0)
O exemplo acima irá imprimir no PHP 7:
int(0) int(1)
Iterar objetos não Traversable agora têm o mesmo comportamento que iterar arrays por referência. Isso resulta na melhora do comportamento quando houver modificações no array durante a iteração também aplicado quando propriedades são adicionadas ou removidas do objeto.
Antes, octais literais que continham números inválidos, eram silenciosamente truncados (0128 se tornaria 012). Agora, um octal literal inválido causará um erro de parse.
Deslocamento de bits por números negativos agora lançarão uma exceção ArithmeticError:
<?php
var_dump(1 >> -1);
?>
O exemplo acima irá imprimir no PHP 5:
int(0)
O exemplo acima irá imprimir no PHP 7:
Fatal error: Uncaught ArithmeticError: Bit shift by negative number in /tmp/test.php:2
Stack trace:
#0 {main}
thrown in /tmp/test.php on line 2
Deslocamentos de bits (em ambas direções), além do tamanho de bits de um inteiro sempre resultará em 0. Antes, o comportamento do deslocamento dependia da arquitetura.
Antes, quando 0 era usado como divisor tanto para a operador de divisão (/) quanto
para o módulo, um E_WARNING era emitido e
false era retornado. Agora, o operador de divisão
retornará um float +INF, -INF ou NAN, conforme a especificação IEEE 754. O E_WARNING do operador módulo
foi removido e irá lançar uma exceção DivisionByZeroError.
<?php
var_dump(3/0);
var_dump(0/0);
var_dump(0%0);
?>
O exemplo acima irá imprimir no PHP 5:
Warning: Division by zero in %s on line %d bool(false) Warning: Division by zero in %s on line %d bool(false) Warning: Division by zero in %s on line %d bool(false)
O exemplo acima irá imprimir no PHP 7:
Warning: Division by zero in %s on line %d float(INF) Warning: Division by zero in %s on line %d float(NAN) PHP Fatal error: Uncaught DivisionByZeroError: Modulo by zero in %s line %d
Strings contendo números hexadecimais não são mais consideradas numéricas. Por exemplo:
<?php
var_dump("0x123" == "291");
var_dump(is_numeric("0x123"));
var_dump("0xe" + "0x1");
var_dump(substr("foo", "0x1"));
?>
O exemplo acima irá imprimir no PHP 5:
bool(true) bool(true) int(15) string(2) "oo"
O exemplo acima irá imprimir no PHP 7:
bool(false) bool(false) int(0) Notice: A non well formed numeric value encountered in /tmp/test.php on line 5 string(3) "foo"
filter_var() pode ser usado se uma string contém um número hexadecimal, e também para converter uma string deste tipo para um inteiro:
<?php
$str = "0xffff";
$int = filter_var($str, FILTER_VALIDATE_INT, FILTER_FLAG_ALLOW_HEX);
if (false === $int) {
throw new Exception("Inteiro Inválido!");
}
var_dump($int); // int(65535)
?>
Por conta da adição da nova sintaxe de escape de códigos em Unicode, strings contendo um \u{ literal seguido de uma sequência inválida causará um erro fatal. Para evitar isso, você deve escapar a barra invertida.
Estas funções foram depreciadas no PHP 4.1.0 em favor de call_user_func() e call_user_func_array(). Você também pode considerar usar funções variáveis e/ou o operador ....
A função depreciada mcrypt_generic_end() foi removida em favor de mcrypt_generic_deinit().
Adicionalmente, as funções depreciadas mcrypt_ecb(),
mcrypt_cbc(), mcrypt_cfb() e
mcrypt_ofb() foram removidas em favor do uso da função
mcrypt_decrypt() com o uso apropriado da constante
MCRYPT_MODE_*.
Os sinônimos depreciados datefmt_set_timezone_id() e IntlDateFormatter::setTimeZoneID() foram removidos em favor de datefmt_set_timezone() e IntlDateFormatter::setTimeZone(), respectivamente.
set_magic_quotes_runtime(), juntamente com seu sinônimo magic_quotes_runtime(), foram removidas. Elas foram depreciadas no PHP 5.3.0, e se tornaram efetivamente não funcionais com a remoção das magic quotes no PHP 5.4.0.
O sinônimo depreciado set_socket_blocking() foi removido em favor de stream_set_blocking().
dl() não pode ser mais utilizado no PHP-FPM. Permanece funcional na interface CLI e SAPIs embarcadas.
O suporte a fontes PostScript Type1 foi removido da extensão GD, resultando na remoção das seguintes funções:
O uso de fontes TruType e funções associadas é recomendado.
As diretivas INI a seguir foram removidas, assim como os como seus recursos associados:
xsl.security_prefs
A diretiva xsl.security_prefs foi removida.
Em substituição, o método XsltProcessor::setSecurityPrefs()
deve ser chamado para controlar as preferências de segurança
por processo base.
O resultado da declaração new não pode mais ser atribuído a uma variável por referência:
<?php
class C {}
$c =& new C;
?>
O exemplo acima irá imprimir no PHP 5:
Deprecated: Assigning the return value of new by reference is deprecated in /tmp/test.php on line 3
O exemplo acima irá imprimir no PHP 7:
Parse error: syntax error, unexpected 'new' (T_NEW) in /tmp/test.php on line 3
Os nomes a seguir não podem ser utilizados como nome de classes, interfaces ou traits
Além disso, os nomes a seguir não devem ser utilizados. Entretanto não será gerado nenhum erro no PHP 7.0, eles são reservados para uso futuro e devem ser considerados depreciados.
O suporte ao uso de tags ASP e script para delimitar o código PHP foi removido. As tags afetadas são:
| Tag de abertura | Tag de fechamento |
|---|---|
<% |
%> |
<%= |
%> |
<script language="php"> |
</script> |
Depreciadas no PHP 5.6, chamadas estáticas feitas em métodos não estáticos em um contexto incompatível irá resultar em chamar o método tendo a variável $this indefinida e um aviso de depreciação ser emitido.
<?php
class A {
public function test() { var_dump($this); }
}
// Note: Does NOT extend A
class B {
public function callNonStaticMethodOfA() { A::test(); }
}
(new B)->callNonStaticMethodOfA();
?>
O exemplo acima irá imprimir no PHP 5:
Deprecated: Non-static method A::test() should not be called statically, assuming $this from incompatible context in /tmp/test.php on line 8
object(B)#1 (0) {
}
O exemplo acima irá imprimir no PHP 7:
Deprecated: Non-static method A::test() should not be called statically in /tmp/test.php on line 8 Notice: Undefined variable: this in /tmp/test.php on line 3 NULL
Parênteses em chamadas ao construtor do yield não são mais necessários, além disso, foi modificados para ser um operador associativo à direita com precedência entre print e =>. Isso pode resultar em um comportamento diferenciado:
<?php
echo yield -1;
// Era interpretado como
echo (yield) - 1;
// E agora é interpretado como
echo yield (-1);
yield $foo or die;
// Era interpretado como
yield ($foo or die);
// E agora é interpretado como
(yield $foo) or die;
?>
Parenteses podem ser utilizados para remover a ambiguidade entre estes casos.
Não é mais possível definir dois ou mais parâmetros em uma função com o mesmo
nome. Por exemplo, a função a seguir vai disparar um
E_COMPILE_ERROR:
<?php
function foo($a, $b, $unused, $unused) {
//
}
?>
Não é mais possível definir dois ou mais blocos default em uma declaração
switch. Por exemplo, a declaração switch a seguir vai disparar um
E_COMPILE_ERROR:
<?php
switch (1) {
default:
break;
default:
break;
}
?>
A variável $HTTP_RAW_POST_DATA não está mais disponível. Ao invés disso o stream php://input deve ser utilizado.
O suporte a prefixar comentários com # nos arquivos INI foi removido. Em vez disso, o ; (ponto-e-vírgula) deve ser usado. Essa mudança aplica-se ao php.ini, assim como arquivos manipulados pelas funções parse_ini_file() e parse_ini_string().
A extensão JSON foi substituída pela JSOND, que causa duas quebras no cálculo básico. Em primeiro lugar, um número não pode ser terminado em um ponto decimal (isto é 34. deve ser modificado para 34.0 ou 34). Em segundo lugar, quando usada a notação científica, o expoente e não deve preceder exatamente o ponto decimal (isto é 3.e3 deve ser modificado para 3.0e3 ou 3e3).
Antes, funções internas silenciosamente truncavam números produzidos por coerções
de pontos flutuantes para inteiros quando o ponto flutuante era
grande demais para ser representado como um inteiro. Agora um E_WARNING será emitido e
NULL retornado.
Quaisquer funções implementadas por manipuladores de sessões que retornem FALSE
ou -1 resultarão em erros fatais. Se qualquer valor retornado
dessas funções não são um booleano, -1, ou 0,
então falhará e um E_WARNING será emitido.
As funções func_get_arg() e func_get_args() anteriormente retornavam os valores originais do argumentos, mesmo depois de modificados. Agora, elas sempre retornam os valores correntes dos argumentos.