...
Eroare PHP · Excepții, JSON și expresii regulate

Fatal error: Uncaught TypeError: Exception::__construct(): Argument #2 ($code) must be of type int, string given in index.php:7

Pe scurt

Al doilea argument al unei excepții, $code, trebuie să fie un număr întreg. Ai trimis un text ('STOC_01' sau codul 'HY000' al unei PDOException). Folosește un cod numeric, iar codurile text pune-le în mesaj sau într-o proprietate proprie a excepției.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Constructorul lui Exception (și al tuturor excepțiilor care o extind) are semnătura __construct(string $message = '', int $code = 0, ?Throwable $previous = null). Când trimiți un text non-numeric ca al doilea argument, PHP aruncă TypeError: Exception::__construct(): Argument #2 ($code) must be of type int, string given.

Partea înșelătoare: TypeError e aruncat în locul excepției tale, deci un catch (StocInsuficient $e) nu îl prinde și scriptul se oprește cu Fatal error.

Cazul clasic e re-aruncarea unei PDOException: throw new RuntimeException($e->getMessage(), $e->getCode()). La PDO, getCode() întoarce SQLSTATE-ul ca text ('HY000', '42S02'). Soluția acolo e $previous: throw new RuntimeException('Eroare DB', 0, $e).

De ce apare: cauzele frecvente

1Cod de eroare text într-o excepție proprie

Greșit
PHP
<?php
class StocInsuficient extends Exception {}
throw new StocInsuficient('Stoc insuficient', 'STOC_01');
Corect
PHP
<?php
class StocInsuficient extends Exception {}
throw new StocInsuficient('Stoc insuficient', 101);

$code e întreg; un cod text poate merge în mesaj sau într-o proprietate separată.

2Re-arunci o PDOException cu codul ei

Greșit
PHP
<?php
try {
    throw new PDOException('no such table', 0);
} catch (PDOException $e) {
    throw new RuntimeException($e->getMessage(), 'HY000');
}
Corect
PHP
<?php
try {
    throw new PDOException('no such table', 0);
} catch (PDOException $e) {
    throw new RuntimeException('Eroare la baza de date', 0, $e);
}

Excepția originală merge ca $previous, cu tot cu codul ei text; noua excepție are cod numeric.

3Vrei un cod text în excepția ta

Greșit
PHP
<?php
throw new Exception('Plată respinsă', 'CARD_EXPIRAT');
Corect
PHP
<?php
class PlataRespinsa extends Exception
{
    public function __construct(public readonly string $motiv)
    {
        parent::__construct("Plată respinsă: $motiv");
    }
}
throw new PlataRespinsa('CARD_EXPIRAT');

Codul text devine o proprietate a excepției, iar constructorul părintelui primește doar mesajul.

Repară tu

Repară eroarea, direct în pagină

Funcția rezerva aruncă o excepție StocInsuficient cu codul text 'STOC_01', iar programul se oprește cu TypeError: Exception::__construct(): Argument #2 ($code) must be of type int, string given, în loc să afișeze mesajul. Folosește codul numeric 101, ca programul să afișeze Stoc insuficient pentru Cort (cod 101).

Codul care dă eroarea
PHP
<?php
class StocInsuficient extends Exception {}

function rezerva(string $produs, int $stoc, int $cerut): void
{
    if ($cerut > $stoc) {
        throw new StocInsuficient("Stoc insuficient pentru $produs", 'STOC_01');
    }
}

try {
    rezerva('Cort', 2, 5);
} catch (StocInsuficient $e) {
    echo $e->getMessage() . ' (cod ' . $e->getCode() . ")\n";
}
După reparație, programul afișează
Stoc insuficient pentru Cort (cod 101)
Indiciu

Al doilea argument al excepției trebuie să fie un int.

Alte forme ale mesajului

  • PHP Fatal error: Uncaught TypeError: Exception::__construct(): Argument #2 ($code) must be of type int, string given in /var/www/html/src/Repo.php:31
  • Fatal error: Uncaught TypeError: RuntimeException::__construct(): Argument #2 ($code) must be of type int, string given in index.php:9
  • Fatal error: Uncaught TypeError: Exception::__construct(): Argument #1 ($message) must be of type string, array given in index.php:5

Cum o eviți pe viitor

  • Folosește coduri numerice în excepții sau, mai bine, clase de excepții diferite pentru situații diferite.
  • La re-aruncare, pune excepția originală ca al treilea argument ($previous), nu copia codul ei.
  • Ține minte că PDOException::getCode() întoarce text (SQLSTATE).
  • Activează declare(strict_types=1);: și codurile numerice scrise ca text ('404') vor fi semnalate.

Întrebări frecvente

De ce codul '404' (cu ghilimele) merge?

Fără strict_types, PHP convertește automat un text numeric în int. Doar un text care nu e număr ('HY000', 'STOC_01') dă TypeError.

De ce nu e prins de catch-ul meu?

Pentru că excepția ta nici n-a apucat să fie creată: constructorul a aruncat un TypeError, care nu e StocInsuficient. Doar un catch (TypeError $e) sau catch (Throwable $e) l-ar prinde.

Erori înrudite

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PHP de la zero, cu exerciții la fiecare lecție

Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.