Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:129560
Precedence: list
MIME-Version: 1.0
References: <CALaXqqQbt-mkXzi1-UZoJ7+ToQ_+izPCm8oc2hmvHZB-9L56YQ@mail.gmail.com>
 <3D90E174-23F2-4B90-B881-20A0AD30CF0C@rwec.co.uk> <31ed0152483193e85ca3a9eebc5e6d14@bastelstu.be>
 <7497bedc-a13e-a627-f733-cb2495249e63@php.net> <AM8P250MB01709E07F27F01C2CF61E833E2A6A@AM8P250MB0170.EURP250.PROD.OUTLOOK.COM>
 <e3b7cb07-0194-46ea-ab44-3eac0e53957b@app.fastmail.com> <DU2P250MB01767A756C75D673F812873FE2A7A@DU2P250MB0176.EURP250.PROD.OUTLOOK.COM>
In-Reply-To: <DU2P250MB01767A756C75D673F812873FE2A7A@DU2P250MB0176.EURP250.PROD.OUTLOOK.COM>
Date: Fri, 5 Dec 2025 10:43:38 +0200
Message-ID: <CAF-mU4yLpLwWt5HJRp6Npx47jhXrQram0zGc42w-LetaHrvNKw@mail.gmail.com>
Subject: Re: [PHP-DEV] [RFC] [Discussion] Stringable Enums
Cc: php internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
From: raveren@gmail.com (=?UTF-8?Q?Rokas_=C5=A0leinius?=)

On Fri, Dec 5, 2025, 02:42 Bob Weinand <bobwei9@hotmail.com> wrote:
>
> Hey Larry,
>
> On 5.12.2025 01:21:43, Larry Garfield wrote:
>
> I've long argued against allowing __toString() for reasons others have al=
ready covered, so I won't bother repeating it.  But off hand I don't see wh=
y __debugInfo() would cause a problem.  I am not sure it's useful before AD=
Ts happen, but I don't think it would cause any harm?
>
> I found to semi-commonly (the ergonomics of querying are bad) add attribu=
tes to enum cases. A __debugInfo() handler could provide information about =
all attached metadata.
>
>
> Bob

Slight correction: not metadata, we already have it in the form of the
entire internal object state. It's full of noise, the user rarely
wants that.

__debugInfo() could contain a user-readable representation of the
important parts of an object.

For example dumping a Carbon object:

Illuminate\Support\Carbon 2025-12-05 09:38:17.634246 Europe/Berlin (+01:00)

vs

Illuminate\Support\Carbon @1764923897 {#304
  #endOfTime: false
  #startOfTime: false
  #constructedObjectId: "00000000000001300000000000000000"
  #localMonthsOverflow: null
  #localYearsOverflow: null
  #localStrictModeEnabled: null
  #localHumanDiffOptions: null
  #localToStringFormat: null
  #localSerializer: null
  #localMacros: null
  #localGenericMacros: null
  #localFormatFunction: null
  #localTranslator: null
  #dumpProperties: array:3 [
    0 =3D> "date"
    1 =3D> "timezone_type"
    2 =3D> "timezone"
  ]
  #dumpLocale: null
  #dumpDateProperties: null
}