PHP 7.1 allows for void and null return types by preceding the type declaration with a ? -- (e.g. function canReturnNullorString(): ?string)
However resource is not allowed as a return type:
<?php
function fileOpen(string $fileName, string $mode): resource
{
$handle = fopen($fileName, $mode);
if ($handle !== false)
{
return $handle;
}
}
$resourceHandle = fileOpen("myfile.txt", "r");
?>
Errors with:
Fatal error: Uncaught TypeError: Return value of fileOpen() must be an instance of resource, resource returned.
Zwracanie wartości
Wartości zwracane są przy użyciu opcjonalnego wyrażenia return. Wszystkie typy mogą być zwracane, łącznie z tablicami i obiektami. Powoduje to natychmiastowe zakończenie wykonywania funkcji i wznowienie wykonywania skryptu od linijki w której funkcja została wywołana. Zobacz return aby uzyskać więcej informacji.
Informacja:
Jeżeli return zostanie pominięte, zwrócona będzie wartość
NULL,
Użycie return
Przykład #1 Użycie return
<?php
function kwadrat($liczba)
{
return $liczba * $liczba;
}
echo kwadrat(4); // wypisuje '16'.
?>
Funkcja nie może zwracać wielu wartości, ale podobny efekt może zostać osiągnięty poprzez zwracanie tablicy.
Przykład #2 Zwracanie tablicy
<?php
function small_numbers()
{
return array (0, 1, 2);
}
list ($zero, $one, $two) = small_numbers();
?>
Aby zwrócić referencję, użyj operatora & zarówno w deklaracji funkcji jak i podczas przypisywania zwracanej wartości zmiennej:
Przykład #3 Zwracanie referencji
<?php
function &returns_reference()
{
return $someref;
}
$newref =& returns_reference();
?>
Aby uzyskać więcej informacji o referencjach, przejdź do Wyjaśnienie Referencji.
Deklaracje typu zwracanej wartości
PHP 7 dodaje wsparcie dla deklaracji zwracanych typów. Podobnie do deklaracji typów argumentów, deklaracje zwracanych typów określają typ wartości, który zostanie zwrócony Przez funkcję. Dostępne są te same typy deklaracji, jak dla deklaracji typu argumetów.
Ścisłe typowanie wpływa także na deklaracje zwracanego typu. W domyślnym, słabym (luźnym) trybie, zwracana wartość może być przekształcona do oczekiwanego typu. W trybie ścisłym zwracana wartość musi być dokładnie oczekiwanego typu, w przeciwnym wypadku zostanie rzucony wyjątek TypeError.
Od PHP 7.1.0 zwracane wartości mogą być oznaczone jako nullowalne poprzez
poprzedzenie nazwy typu znakiem zapytania (?). Oznacza to,
że funkcja zwraca podany typ lub NULL.
Informacja:
Podczas nadpisywania metody nadrzędnej, metoda potomka musi mieć zwracany typ zgodny ze swoim rodzicem. Jeżeli rodzic nie określa zwracanego typu, to metoda potomna może to zrobić.
Przykłady
Przykład #4 Podstawowa deklaracja zwracanego typu
<?php
function sum($a, $b): float {
return $a + $b;
}
// Zwauważ że zwrócona będzie wartość typu float.
var_dump(sum(1, 2));
?>
Powyższy przykład wyświetli:
float(3)
Przykład #5 Tryb ścisły w akcji
<?php
declare(strict_types=1);
function sum($a, $b): int {
return $a + $b;
}
var_dump(sum(1, 2));
var_dump(sum(1, 2.5));
?>
Powyższy przykład wyświetli:
int(3)
Fatal error: Uncaught TypeError: Return value of sum() must be of the type integer, float returned in - on line 5 in -:5
Stack trace:
#0 -(9): sum(1, 2.5)
#1 {main}
thrown in - on line 5
Przykład #6 Zwracanie obiektu
<?php
class C {}
function getC(): C {
return new C;
}
var_dump(getC());
?>
Powyższy przykład wyświetli:
object(C)#1 (0) {
}
Przykład #7 Deklaracja zwracanego typu akceptująca NULL (od PHP 7.1.0)
<?php
function get_item(): ?string {
if (isset($_GET['item'])) {
return $_GET['item'];
} else {
return null;
}
}
?>
add a note
User Contributed Notes 10 notes
ryan dot jentzsch at gmail dot com ¶
7 years ago
rstaveley at seseit dot com ¶
13 years ago
Developers with a C background may expect pass by reference semantics for arrays. It may be surprising that pass by value is used for arrays just like scalars. Objects are implicitly passed by reference.
<?php
# (1) Objects are always passed by reference and returned by reference
class Obj {
public $x;
}
function obj_inc_x($obj) {
$obj->x++;
return $obj;
}
$obj = new Obj();
$obj->x = 1;
$obj2 = obj_inc_x($obj);
obj_inc_x($obj2);
print $obj->x . ', ' . $obj2->x . "\n";
# (2) Scalars are not passed by reference or returned as such
function scalar_inc_x($x) {
$x++;
return $x;
}
$x = 1;
$x2 = scalar_inc_x($x);
scalar_inc_x($x2);
print $x . ', ' . $x2 . "\n";
# (3) You have to force pass by reference and return by reference on scalars
function &scalar_ref_inc_x(&$x) {
$x++;
return $x;
}
$x = 1;
$x2 =& scalar_ref_inc_x($x); # Need reference here as well as the function sig
scalar_ref_inc_x($x2);
print $x . ', ' . $x2 . "\n";
# (4) Arrays use pass by value sematics just like scalars
function array_inc_x($array) {
$array{'x'}++;
return $array;
}
$array = array();
$array['x'] = 1;
$array2 = array_inc_x($array);
array_inc_x($array2);
print $array['x'] . ', ' . $array2['x'] . "\n";
# (5) You have to force pass by reference and return by reference on arrays
function &array_ref_inc_x(&$array) {
$array{'x'}++;
return $array;
}
$array = array();
$array['x'] = 1;
$array2 =& array_ref_inc_x($array); # Need reference here as well as the function sig
array_ref_inc_x($array2);
print $array['x'] . ', ' . $array2['x'] . "\n";
bgalloway at citycarshare dot org ¶
16 years ago
Be careful about using "do this thing or die()" logic in your return lines. It doesn't work as you'd expect:
<?php
function myfunc1() {
return('thingy' or die('otherthingy'));
}
function myfunc2() {
return 'thingy' or die('otherthingy');
}
function myfunc3() {
return('thingy') or die('otherthingy');
}
function myfunc4() {
return 'thingy' or 'otherthingy';
}
function myfunc5() {
$x = 'thingy' or 'otherthingy'; return $x;
}
echo myfunc1(). "\n". myfunc2(). "\n". myfunc3(). "\n". myfunc4(). "\n". myfunc5(). "\n";
?>
Only myfunc5() returns 'thingy' - the rest return 1.
nick at itomic.com ¶
20 years ago
Functions which return references, may return a NULL value. This is inconsistent with the fact that function parameters passed by reference can't be passed as NULL (or in fact anything which isnt a variable).
i.e.
<?php
function &testRet()
{
return NULL;
}
if (testRet() === NULL)
{
echo "NULL";
}
?>
parses fine and echoes NULL
Berniev ¶
5 years ago
Be careful when introducing return types to your code.
Only one return type can be specified (but prefacing with ? allows null).
Return values of a type different to that specified are silently converted with sometimes perplexing results. These can be tedious to find and will need rewriting, along with calling code.
Declare strict types using "declare(strict_types=1);" and an error will be generated, saving much head-scratching.
zored dot box at gmail dot com ¶
6 years ago
You may specify child return type if there is no parent:
<?php
class A {
public function f ($a)
{
return 1;
}
}
class B extends A {
public function f ($a): int // + return type, OK
{
return 1;
}
}
class C extends A {
public function f (int $a) // + argument type, WARNING
{
return 1;
}
}
?>
k-gun !! mail ¶
7 years ago
With 7.1, these are possible yet;
<?php
function ret_void(): void {
// do something but no return any value
// if needs to break fn exec for any reason simply write return;
if (...) {
return; // break
// return null; // even this NO!
}
$db->doSomething();
// no need return call anymore
}
function ret_nullable() ?int {
if (...) {
return 123;
} else {
return null; // MUST!
}
}
?>
ryan dot jentzsch at gmail dot com ¶
8 years ago
PHP 7 return types if specified can not return a null.
For example:
<?php
declare(strict_types=1);
function add2ints(int $x, int $y):int
{
$z = $x + $y;
if ($z===0)
{
return null;
}
return $z;
}
$a = add2ints(3, 4);
echo is_null($a) ? 'Null' : $a;
$b = add2ints(-2, 2);
echo is_null($b) ? 'Null' : $b;
exit();
Output:
7
Process finished with exit code 139
php(@)genjo(DOT)fr ¶
4 years ago
Declaring a collection of objects as return type is not implemented and forbidden:
<?php
class Child{}
function getChilds(): Child[]
{
return [(new Child()), (new Child())];
}
var_dump(getChilds());
// Returns: Parse error: syntax error, unexpected '[', expecting '{'
?>
We have to use:
<?php
class Child{}
function getChilds(): array
{
return [(new Child()), (new Child())];
}
var_dump(getChilds());
// Returns:
/*
array (size=2)
0 =>
object(Child)[168]
1 =>
object(Child)[398]
*/
?>
Idem for function parameter:
<?php
function setChilds(Child[] $childs){}
// Not allowed
function setChilds(array $childs){}
// Allowed
?>
Vidmantas Maskoliunas ¶
8 years ago
Note: the function does not have "alternative syntax" as if/endif, while/endwhile, and colon (:) here is used to define returning type and not to mark where the block statement begins.
