Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:126442
X-Original-To: internals@lists.php.net
Delivered-To: internals@lists.php.net
Received: from php-smtp4.php.net (php-smtp4.php.net [45.112.84.5])
	by qa.php.net (Postfix) with ESMTPS id A22E31A00BC
	for <internals@lists.php.net>; Tue, 18 Feb 2025 11:36:02 +0000 (UTC)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail;
	t=1739878401; bh=dJblkQpq15T/tzaHXoQY6AznrTsTVMUm/zj2VS8Aqgc=;
	h=Date:From:To:Subject:In-Reply-To:References:From;
	b=fkp75R76ZwfnI6PRLJ36Q+lYt5yEGlTuGAuvuqtQXPKTEV01voPtuufaXIKXRigtm
	 evlRrc+35QUEuk0EaTcwYLlw7k13EqS3xF/WpCoqR/lwFI6JkRCLn2KYjF7PGSUuQY
	 jbjbOEwmkTz52RuqpVcgTJNSoDzwZYCrMTvfsWiqRZjoxFWTZVu4Oa7JCpJVLrbE53
	 6wDmiKVIHBQ/SVHIfDmFvmz9lc2nA35X5FPgMYSoUSR7Nksux91qLxf1VoQbCo19hp
	 T/4md6RzYPLYSiK4trN9n1TT9aVkZ0hR0jScnyn7/ZX8rklJ1aMbkyY25xTi1WMUV5
	 h/1xG40x1nMjg==
Received: from php-smtp4.php.net (localhost [127.0.0.1])
	by php-smtp4.php.net (Postfix) with ESMTP id D4401180059
	for <internals@lists.php.net>; Tue, 18 Feb 2025 11:33:20 +0000 (UTC)
X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on php-smtp4.php.net
X-Spam-Level: 
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
	DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_PASS,SPF_HELO_NONE,
	SPF_PASS autolearn=no autolearn_force=no version=4.0.0
X-Spam-Virus: No
X-Envelope-From: <tim@bastelstu.be>
Received: from chrono.xqk7.com (chrono.xqk7.com [176.9.45.72])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
	(No client certificate requested)
	by php-smtp4.php.net (Postfix) with ESMTPS
	for <internals@lists.php.net>; Tue, 18 Feb 2025 11:33:20 +0000 (UTC)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bastelstu.be;
	s=mail20171119; t=1739878560;
	bh=JDn26XkMGyDNEAKmR8EDz2omYrLmortuteQG54w2iNg=;
	h=MIME-Version:Date:From:To:Subject:In-Reply-To:References:
	 Message-ID:Content-Type:from:to:cc:subject:message-id;
	b=n+JIdYQUkFGhXbJSuZjNSPCpoxPKEMUoLsCN2iCybwwYHy/7HWyPcfNoR83LmHD/c
	 dHpFy5LKgR8eL7Ko8ebaZT/M/y5imr6LnNufg6ibBIr98ecT/02lyzwfetnj02m+3f
	 6si1gGJwku0cLWeaPMjUITbo8s/2epMcGr0CtDpMt9eCXGJaYmRyBfFH0E3k5y/Es+
	 RFgfZs37jyuyQH8zpjJSaH0NHiouznf6Z6iWWmuopWYj+8TKPoYZyWvyNHVYVakcYT
	 ekssViR+L6auPWrWrv9IT9/7lwKCgk4maNQTesRl84E23t0vVG2UnM/WHE33KnMVsf
	 b3/MbzPKrwM6A==
Precedence: bulk
list-help: <mailto:internals+help@lists.php.net
list-unsubscribe: <mailto:internals+unsubscribe@lists.php.net>
list-post: <mailto:internals@lists.php.net>
List-Id: internals.lists.php.net
x-ms-reactions: disallow
MIME-Version: 1.0
Date: Tue, 18 Feb 2025 12:36:00 +0100
To: internals@lists.php.net
Subject: Re: [PHP-DEV] Concept: constructor overloading syntax sugar
In-Reply-To: <BB121A3F-789F-4FEA-B032-ABC455E1E56C@rwec.co.uk>
References: <CAA0W4qKeJ-KXGmQFCsF6wMN746cbFhUF-D71zxdNtX2xrU_tCg@mail.gmail.com>
 <BB121A3F-789F-4FEA-B032-ABC455E1E56C@rwec.co.uk>
Message-ID: <7215164add3b7a2a4d3142f959292a4e@bastelstu.be>
Content-Type: text/plain; charset=UTF-8;
 format=flowed
Content-Transfer-Encoding: 8bit
From: tim@bastelstu.be (=?UTF-8?Q?Tim_D=C3=BCsterhus?=)

Hi

Am 2025-02-18 09:00, schrieb Rowan Tommins [IMSoP]:
> Personally, I think quite the opposite: named constructors make a lot 
> more sense than type-based overloads. For instance, you might have both 
> createFromJson and createFromYaml; their inputs are both going to be 
> "string" as far as the type system is concerned, so overloading would 
> be useless.

To add an example from PHP’s standard library: The new DOM API shipped 
in PHP 8.4 uses named constructors to create documents and requires this 
to distinguish between `createFromFile` and `createFromString`.

https://github.com/php/php-src/blob/da38477544c76c2f034ad74dfd2e1fe613030a31/ext/dom/php_dom.stub.php#L2041-L2045

     final class HTMLDocument extends Document
     {
         public static function createEmpty(string $encoding = "UTF-8"): 
HTMLDocument {}

         public static function createFromFile(string $path, int $options 
= 0, ?string $overrideEncoding = null): HTMLDocument {}

         public static function createFromString(string $source, int 
$options = 0, ?string $overrideEncoding = null): HTMLDocument {}

         // […]
     }

Best regards
Tim Düsterhus