feature #59035 [VarDumper] Add casters for object-converted resources (alexandre-daubois)

This PR was squashed before being merged into the 7.3 branch.

Discussion
----------

[VarDumper] Add casters for object-converted resources

| Q             | A
| ------------- | ---
| Branch?       | 7.3
| Bug fix?      | no
| New feature?  | yes
| Deprecations? | yes
| Issues        | -
| License       | MIT

This PR makes up for the backlog of resources transformed into objects in the latest versions of PHP.

✅ Support added (or already existing with an update in `AbstractCloner`):
- ext-curl
    - `CurlMultiHandle`: **no information to gather**
- ext-openssl
  -  `OpenSSLCertificateSigningRequest`
  - `OpenSSLAsymmetricKey`
- ext-finfo
  - **No information to gather**
- ext-sqlite3
	- `Sqlite3Result`
- ext-sockets
	- `Sockets` (to rebase on symfony/symfony#59026)
- ext-pgsql
	- `PgSql\Lob`
	- `PgSql\Connection`
	- `PgSql\Result`

⚠️ Remaining classes I couldn't test/find enough info yet (introduced in PHP 8.4):
- `Odbc\Connection`
- `Odbc\Result`
- `Soap\Url`
- `Soap\Sdl`

Commits
-------

7be64835c4b [VarDumper] Add casters for object-converted resources

Author: nicolas-grekas

CHANGELOG.md

@@ -1,6 +1,13 @@
 CHANGELOG
 =========
 
+7.3
+---
+
+ * Add casters for `Dba\Connection`, `SQLite3Result`, `OpenSSLAsymmetricKey` and `OpenSSLCertificateSigningRequest`
+ * Deprecate `ResourceCaster::castCurl()`, `ResourceCaster::castGd()` and `ResourceCaster::castOpensslX509()`
+ * Mark all casters as `@internal`
+
 7.2
 ---
 

Caster/AddressInfoCaster.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Nicolas Grekas <[email protected]>
+ *
+ * @internal since Symfony 7.3
  */
 final class AddressInfoCaster
 {

Caster/AmqpCaster.php

@@ -19,6 +19,8 @@
  * @author Grégoire Pineau <[email protected]>
  *
  * @final
+ *
+ * @internal since Symfony 7.3
  */
 class AmqpCaster
 {

Caster/Caster.php

@@ -46,6 +46,8 @@ class Caster
      * Casts objects to arrays and adds the dynamic property prefix.
      *
      * @param bool $hasDebugInfo Whether the __debugInfo method exists on $obj or not
+     *
+     * @internal since Symfony 7.3
      */
     public static function castObject(object $obj, string $class, bool $hasDebugInfo = false, ?string $debugClass = null): array
     {
@@ -162,6 +164,9 @@ public static function filter(array $a, int $filter, array $listedProperties = [
         return $a;
     }
 
+    /**
+     * @internal since Symfony 7.3
+     */
     public static function castPhpIncompleteClass(\__PHP_Incomplete_Class $c, array $a, Stub $stub, bool $isNested): array
     {
         if (isset($a['__PHP_Incomplete_Class_Name'])) {

Caster/CurlCaster.php

@@ -0,0 +1,31 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas <[email protected]>
+ *
+ * @internal
+ */
+final class CurlCaster
+{
+    public static function castCurl(\CurlHandle $h, array $a, Stub $stub, bool $isNested): array
+    {
+        foreach (curl_getinfo($h) as $key => $val) {
+            $a[Caster::PREFIX_VIRTUAL.$key] = $val;
+        }
+
+        return $a;
+    }
+}

Caster/DOMCaster.php

@@ -19,6 +19,8 @@
  * @author Nicolas Grekas <[email protected]>
  *
  * @final
+ *
+ * @internal since Symfony 7.3
  */
 class DOMCaster
 {

Caster/DateCaster.php

@@ -19,6 +19,8 @@
  * @author Dany Maillard <[email protected]>
  *
  * @final
+ *
+ * @internal since Symfony 7.3
  */
 class DateCaster
 {

Caster/DoctrineCaster.php

@@ -22,6 +22,8 @@
  * @author Nicolas Grekas <[email protected]>
  *
  * @final
+ *
+ * @internal since Symfony 7.3
  */
 class DoctrineCaster
 {

Caster/ExceptionCaster.php

@@ -22,6 +22,8 @@
  * @author Nicolas Grekas <[email protected]>
  *
  * @final
+ *
+ * @internal since Symfony 7.3
  */
 class ExceptionCaster
 {

Caster/GdCaster.php

@@ -0,0 +1,30 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\VarDumper\Caster;
+
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Nicolas Grekas <[email protected]>
+ *
+ * @internal
+ */
+final class GdCaster
+{
+    public static function castGd(\GdImage $gd, array $a, Stub $stub, bool $isNested): array
+    {
+        $a[Caster::PREFIX_VIRTUAL.'size'] = imagesx($gd).'x'.imagesy($gd);
+        $a[Caster::PREFIX_VIRTUAL.'trueColor'] = imageistruecolor($gd);
+
+        return $a;
+    }
+}