minor #30035 Mark some/most implementations of Serializable as @internal (nicolas-grekas)

This PR was merged into the 3.4 branch.

Discussion
----------

Mark some/most implementations of Serializable as `@internal`

| Q             | A
| ------------- | ---
| Branch?       | 3.4
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | -
| License       | MIT
| Doc PR        | -

There are more usages of `Serializable` in the code base, but the remaining are unfortunately exposed as part of interfaces.

All these places are IMHO already considered internal, this just makes it explicit.

Will ease moving away from `Serializable`.

Commits
-------

7b9d73d891 Mark some/most implementations of Serializable as `@internal`

Author: nicolas-grekas

Resource/ClassExistenceResource.php

@@ -97,7 +97,7 @@ public function isFresh($timestamp)
     }
 
     /**
-     * {@inheritdoc}
+     * @internal
      */
     public function serialize()
     {
@@ -109,7 +109,7 @@ public function serialize()
     }
 
     /**
-     * {@inheritdoc}
+     * @internal
      */
     public function unserialize($serialized)
     {

Resource/ComposerResource.php

@@ -51,11 +51,17 @@ public function isFresh($timestamp)
         return self::$runtimeVendors === $this->vendors;
     }
 
+    /**
+     * @internal
+     */
     public function serialize()
     {
         return serialize($this->vendors);
     }
 
+    /**
+     * @internal
+     */
     public function unserialize($serialized)
     {
         $this->vendors = unserialize($serialized);

Resource/DirectoryResource.php

@@ -104,11 +104,17 @@ public function isFresh($timestamp)
         return true;
     }
 
+    /**
+     * @internal
+     */
     public function serialize()
     {
         return serialize([$this->resource, $this->pattern]);
     }
 
+    /**
+     * @internal
+     */
     public function unserialize($serialized)
     {
         list($this->resource, $this->pattern) = unserialize($serialized);

Resource/FileExistenceResource.php

@@ -59,15 +59,15 @@ public function isFresh($timestamp)
     }
 
     /**
-     * {@inheritdoc}
+     * @internal
      */
     public function serialize()
     {
         return serialize([$this->resource, $this->exists]);
     }
 
     /**
-     * {@inheritdoc}
+     * @internal
      */
     public function unserialize($serialized)
     {

Resource/FileResource.php

@@ -63,11 +63,17 @@ public function isFresh($timestamp)
         return false !== ($filemtime = @filemtime($this->resource)) && $filemtime <= $timestamp;
     }
 
+    /**
+     * @internal
+     */
     public function serialize()
     {
         return serialize($this->resource);
     }
 
+    /**
+     * @internal
+     */
     public function unserialize($serialized)
     {
         $this->resource = unserialize($serialized);

Resource/GlobResource.php

@@ -73,6 +73,9 @@ public function isFresh($timestamp)
         return $this->hash === $hash;
     }
 
+    /**
+     * @internal
+     */
     public function serialize()
     {
         if (null === $this->hash) {
@@ -82,6 +85,9 @@ public function serialize()
         return serialize([$this->prefix, $this->pattern, $this->recursive, $this->hash]);
     }
 
+    /**
+     * @internal
+     */
     public function unserialize($serialized)
     {
         list($this->prefix, $this->pattern, $this->recursive, $this->hash) = unserialize($serialized);

Resource/ReflectionClassResource.php

@@ -57,6 +57,9 @@ public function __toString()
         return 'reflection.'.$this->className;
     }
 
+    /**
+     * @internal
+     */
     public function serialize()
     {
         if (null === $this->hash) {
@@ -67,6 +70,9 @@ public function serialize()
         return serialize([$this->files, $this->className, $this->hash]);
     }
 
+    /**
+     * @internal
+     */
     public function unserialize($serialized)
     {
         list($this->files, $this->className, $this->hash) = unserialize($serialized);