Typowanie funkcji w PHP: int, string, array, bool, mixed, void, object, ?int

Wprowadzenie do typowania funkcji w PHP

Jeśli kiedykolwiek mieliście do czynienia z programowaniem w PHP, to na pewno wiecie, jak frustrujące może być zmaganie się z błędami, które w magiczny sposób pojawiają się w momencie, gdy najmniej się tego spodziewacie. Załóżmy, że wysyłacie formularz, a zamiast oczekiwanego wyniku, wyskakuje Wam komunikat o błędzie.
Co poszło nie tak? Czasami to kwestia nieodpowiedniego typu danych, które do Waszych funkcji trafiły. Dlatego właśnie typowanie funkcji w PHP odgrywa kluczową rolę w zwiększaniu nie tylko przejrzystości, ale również bezpieczeństwa Waszego kodu.

W PHP 7.0 oraz kolejnych wersjach wprowadzono solidniejsze mechanizmy typowania, które pozwalają programistom określić, jakie typy danych mogą być przekazywane do funkcji. Wyobraźcie sobie, że każdy typ danych to ryba w akwarium.
Jeżeli wpuścicie do akwarium nieodpowiedni gatunek, to nie tylko ryby, ale również cały ekosystem zostanie poważnie zaburzony. Podobnie jest w kodzie – przekazanie niewłaściwego typu danych może prowadzić do chaosu i nieprzewidywalnych zachowań waszego programu.

Typy funkcji w PHP

W PHP mamy do dyspozycji kilka typów funkcji, takich jak:

• int: do przechowywania liczb całkowitych
• string: idealny do tekstów
• array: do grup danych
• bool: do wartości prawda/fałsz
• mixed: dla wielu typów danych
• void: funkcja, która nic nie zwraca
• object: dla instancji klas
• ?int: wskazuje, że wartość może być liczbą całkowitą lub null

Niezastosowanie typowania może prowadzić do sytuacji, w których próbujecie wykonać operacje na danych, które nie mają sensu, na przykład mnożenie tekstu przez liczbę. Już widzę te pytające spojrzenia… Tak, to się zdarza!

Typowanie funkcji nie tylko pomaga w wykrywaniu błędów na wczesnym etapie, ale także czyni Wasz kod łatwiejszym do zrozumienia i utrzymania. Wyobraźcie sobie, że Wasz kod to książka, a typy danych to rozdziały.
Kiedy każdy rozdział jest odpowiednio podpisany, łatwiej być czytelnikowi zorientować się w treści. Tak samo w kodzie – jasne określenie, jaki typ danych oczekuje funkcja, czyni kod bardziej zrozumiałym dla innych programistów (i dla Was samych w przyszłości!).

W tej serii artykułów przyjrzymy się dokładniej wszystkim wymienionym wcześniej typom danych, ich zastosowaniom oraz korzyściom płynącym z ich wykorzystywania. Zobaczymy, jak typy funkcji mogą poprawić jakość Waszego kodu, ale także pomogą uniknąć wielu irytujących błędów. Kiedy jasno określicie, z jakimi typami danych pracujecie, Wasz kod będzie nie tylko bardziej elegancki, ale również bardziej bezpieczny. A kto nie chce stworzyć bezpieczniejszego i bardziej przejrzystego oprogramowania?

Zapraszam do odkrywania świata typowania funkcji w PHP, bo to naprawdę fascynująca podróż. A cóż lepszego, niż lepszy kod w naszych projektach? Zaczynajmy!

Typy skalarne w PHP

Jeśli wchodzisz do świata PHP, prawdopodobnie słyszałeś o typach skalarne. Ale czy kiedykolwiek zastanowiłeś się, jak ono naprawdę działa? Typy skalarne, takie jak int, string, bool i mixed, są jak podstawowe ingrediencje w kuchni – bez nich nie stworzysz żadnego wykwintnego dania. Dlatego zanim przejdziesz do bardziej złożonych typów danych czy obiektów, dobrze jest zrozumieć te, które stanowią fundament PHP. Tak, jak nie można zrobić dobrego ciasta bez mąki, w programowaniu nie poradzisz sobie bez pewnych podstawowych typów.

Najpierw przyjrzyjmy się integerom. Typ int w PHP to liczby całkowite. Możemy je znaleźć wszędzie: w kalkulacjach, zliczaniu iteracji w pętlach czy przechowywaniu licznych danych użytkowników. Na przykład, jeżeli chcesz zliczyć, ilu razy użytkownik wszedł na twoją stronę w danym dniu, skorzystasz z integera. Prosty przykład może wyglądać tak:

// This variable holds the number of page visits
$pageVisits = 20;

W tym kontekście 20 to liczba całkowita, która mówi, jak często użytkownicy wpadają do naszego wirtualnego świata. Int jest więc narzędziem, które sprawia, że nasze kalkulacje są szybsze i łatwiejsze.

Teraz porozmawiajmy o stringach. Ones są niczym innym jak sekwencjami znaków, które możemy używać do przechowywania tekstu. Almost everything thrives on strings – od imion użytkowników, przez adresy e-mail, po różne komunikaty. Jeśli chcesz powitać swoje miliony użytkowników, nie ma nic lepszego niż prosty echo. Oto przykład:

// Greeting a user
$userName = "John";
echo "Welcome, " . $userName . "!";

Używając zmiennej $userName, witamy użytkownika, co pokazuje, jak string może wzbogacić doświadczenie użytkownika i sprawić, że poczują się ważni.

Nie możemy jednak zapomnieć o booleanach, znanych również jako bool. To bardzo spójny typ, jak czarny lub biały, prawda? Służy do przechowywania stanów logicznych – true lub false. Idealny do sprawdzania warunków, np. jeśli użytkownik jest zalogowany lub nie:

// Check if the user is logged in
$isLoggedIn = true;
if ($isLoggedIn) {
    echo "User is logged in.";
} else {
    echo "User is logged out.";
}

W tym przypadku $isLoggedIn jest typem bool, który pozwala nam na wykonanie konkretnych operacji w zależności od stanu. Takie proste, a tak efektywne!

A co z typem mixed? To jak tajemniczy składnik w przepisie – nie wiesz, co dostaniesz! Mixed oznacza, że zmienna może przyjmować różne typy – od intów po stringi. To świetne rozwiązanie, gdy nie masz pojęcia, co dokładnie przyjdzie do ciebie w przyszłości. Przydatne w sytuacjach, gdzie korzystasz z szerszego zestawu danych, chociaż nie zawsze jest to najlepsza praktyka, ponieważ może prowadzić do zamieszania.

// Function that can accept various types
function processInput($input): mixed {
    return $input;
}
echo processInput(100); // This will return an integer
echo processInput("Test"); // This will return a string

Jak widzisz, typy skalarne stanowią podstawowy element w programowaniu w PHP. Dzięki nim nasze zmienne stają się bardziej zorganizowane, co prowadzi do lepszego zrozumienia i wydajności w projektach. Czegóż chcieć więcej, gdy czujesz się jak szef kuchni, tworząc coś wyjątkowego?

Możesz też chcieć jako parametr móc otrzymać "null" (bo wcześniej informacja nie została uzupełniona) lub string i zwracać albo null albo string

// Function that can accept various types
function processFirstName(?string $firstName): ?string {
     if(empty($firstName))
         return null;

     return $firstName;
}

// OR

function processFirstName(null|string $firstName): null|string {
     if(empty($firstName))
         return null;

     return $firstName;
}

Jak widzisz, typy skalarne stanowią podstawowy element w programowaniu w PHP. Dzięki nim nasze zmienne stają się bardziej zorganizowane, co prowadzi do lepszego zrozumienia i wydajności w projektach. Czegóż chcieć więcej, gdy czujesz się jak szef kuchni, tworząc coś wyjątkowego?

Typ void oraz nullable types w PHP

Typowanie funkcji w PHP przypomina wybór odpowiedniego narzędzia w skrzynce narzędziowej: każdy typ ma swoje specyfikacje, które grantingują nam możliwość działania w określony sposób. Dziś skupimy się na typie, który sprawia, że nasze funkcje są nie tylko bardziej przejrzyste, ale także semantycznie zrozumiałe - mowa tu o typie void oraz o typach nullable, które przychodzą nam z pomocą, gdy musimy uwzględnić możliwość braku wartości.

Najpierw zaczniemy od void. Użycie tego typu jest jak postawienie znaku „stop” przed naszą funkcją, co oznacza, że nie zamierzamy nic zwracać. W praktyce, gdy zadeklarujemy funkcję jako void, deklarujemy zamiar wykonania jakiejś akcji bez zwracania rezultatu. Może to być trochę jak szef kuchni, który wydaje polecenia w kuchni, ale nie wysyła nic na stół. Dzięki temu nasze funkcje stają się bardziej jednoznaczne, co jest ogromnym plusem w złożonych projektach. Oto przykład użycia:

// Function declaration with 'void' return type
function sendEmail(string $recipient, string $message): void {
    // Logic for sending the email
    mail($recipient, "Subject", $message);
}

W powyższym przykładzie mamy do czynienia z funkcją sendEmail, która wykonuje określoną akcję, ale nie zwraca nic na zewnątrz. To, co powinno być zrozumiane, to to, że deklaracja jako void zapewnia, że nie możemy przypadkowo próbować przypisać wartości do wywołania tej funkcji. W ten sposób wspieramy zachowania programistyczne, które są zgodne z ideą czystego kodu.

Kiedy już zrozumiesz ideę void, przyszedł czas na odkrycie magicznego znaku zapytania: ?. To, co on reprezentuje, znaczy więcej, niż się wydaje, i może być kluczem do większej elastyczności w programowaniu w PHP. Typy nullable pozwalają nam na zwracanie wartości danego typu lub pojawienie się wartości null. Jak to działa? Dający do zrozumienia przykład mógłby wyglądać jak poniżej:

// Function declaration with nullable integer return type
function getUserAge(string $username): ?int {
    // Simulating fetching user's age
    return ($username === 'admin') ? 30 : null;
}

W powyższym przykładzie, funkcja getUserAge przeszukuje bazę danych, aby znaleźć wiek użytkownika. Jeśli użytkownik się nazywa "admin", funkcja zwraca 30. A co, jeśli użytkownik nie istnieje? W tym wypadku zwróci null, co jest jak wysłanie do nas informacji, że „nie ma takiego zamówienia” w menu. Znak zapytania przed typem int informuje nas, że funkcja ma możliwość zwrócenia jednego z dwóch rezultatów - konkretnej liczby całkowitej lub null. To, co jest kluczowe w implementacji nullable types, to umiejętność radzenia sobie z null i unikanie potencjalnych błędów wykonania, co może być plaga w bardziej złożonych aplikacjach.

Wniosek? Typy void oraz nullable types zwiększają semantykę naszego kodu, czyniąc go bardziej przejrzystym i przewidywalnym. Używając tych mechanizmów, nie tylko dostajemy większą kontrolę nad tym, co nasze funkcje robią, ale także, co jeszcze bardziej wartościowe, unikamy potencjalnych pułapek, które mogą zaskoczyć nas, wprowadzając null tam, gdzie go nie chcieliśmy. Unikamy zamienia się w szefa kuchni, któremu wszystkie potrawy i świeże składniki idealnie dopasowują się do obranego celu - a przecież kogo nie cieszy sukces?

Wszystko, co dobre, kiedyś się kończy, i tak jak każda emocjonująca podróż, nasza eksploracja typów w PHP dobiega końca. Jednak zanim przystąpimy do ostatecznego rozrachunku i zamknięcia tego rozdziału, warto przyjrzeć się korzyściom płynącym z typowania funkcji. Kto by pomyślał, że w świecie programowania można znaleźć tak wiele przyjemności w różnicowaniu typów? Pozwól, że zabiorę Cię przez kilka kluczowych zalet, które sprawiają, że typowanie w PHP jest niezastąpionym narzędziem każdego programisty.

Korzyści z typowania funkcji w PHP

• Bezpieczeństwo kodu – zaczynając od jednego z najważniejszych aspektów, typowanie funkcji w PHP znacząco zwiększa bezpieczeństwo Twojego kodu. Wyobraź sobie, że piszesz kod, który ma przyjąć tylko liczby całkowite, a nagle do funkcji wkrada się nieproszony gość w postaci ciągu znaków. Dla większości programistów byłoby to nieprzyjemne zaskoczenie, ale dzięki jasno określonym typom możesz zapobiec takim sytuacjom.
  PHP pomocniczo wyrzuci błąd, zanim kod trafi na produkcję, co pozwoli zaoszczędzić sporo czasu podczas debugowania. W końcu, kto chce spędzać czas na szukaniu igły w stogu siana, gdy można jej po prostu nie wrzucać?
• Lepsza czytelność i zrozumienie kodu – wyobraź sobie, że Twój kod to instrukcja obsługi dla nowego znajomego. Jeśli jest jasny i zrozumiały, twoja przyjaźń szybko się rozwija; jednak jeśli instrukcje są niejasne, możesz skończyć na przedstawieniu niezrozumiałych pojęć.
  Typowanie funkcji w PHP działa jak dobrze zaprojektowana mapa. Mówiąc jasno, jakie typy danych mogą być używane w funkcjach, sprawiasz, że kod staje się bardziej zrozumiały dla innych programistów (i dla Ciebie samego w przyszłości).
• Łatwiejsze debugowanie – brak typów to jak jazda do nieznanego celu bez GPS; może być ekscytująco, ale prędzej czy później zgubisz się. 
  Typy w PHP, z drugiej strony, działają jak wytrwały przewodnik. Dzięki odpowiednio zdefiniowanym typom błędy są znacznie łatwiejsze do wychwycenia, a Ty nie musisz frustrować się na próbach zrozumienia, co poszło nie tak.
  Wiesz, że coś jest nie tak, gdy nagle funkcja zwraca nie to, co powinna, a typowanie nerwowo podpowiada, co dokładnie mogło się pomieszać w twoim kodzie.
• Zmniejszenie ryzyka błędów – tak, to kolejny element układanki, który zamienia PHP w prawdziwych superbohaterów kodowania. Kiedy funkcje zwracają odpowiednie typy, ryzyko pojawienia się nieprzewidzianych błędów zmniejsza się niemal do zera. Typowane funkcje stają się niezawodne jak dobrze naoliwiony mechanizm zegarowy, obniżając ryzyko niechcianych niespodzianek podczas wykonywania aplikacji.

Wszystko to prowadzi do jednego, wspólnego mianownika: przejrzystości i utrzymywania kodu. Mając pełną kontrolę nad typami, programiści dosłownie zwalniają z łańcucha kody, które wcześniej były ciche, lecz chaotyczne. 
I chociaż może to wymagać nieco więcej pracy na początku, rezultaty ukończenia tego trudnego etapu kodowania są bezcenne. Typowanie w PHP działa podobnie do marynistycznej latarni, która prowadzi Cię bezpiecznie do portu, nawet podczas sztormu. Zyskujesz nie tylko więcej pewności siebie, ale również zdobędziesz szacunek i zaufanie swojego zespołu.