Update phpDoc for Getter and Setter traits

src/Traits/Getter.php

@@ -28,6 +28,15 @@ use InvalidArgumentException;
 /**
  * Reads data from inaccessible properties by using magic methods.
  *
+ * To make a `protected` or `private` property readable, provide a method named
+ * `_magicGet{Property}()` which handles the reading. Replace `{Property}` in
+ * the method's name with the name of the actual property (with an uppercase
+ * first letter).
+ *
+ * > Example: If the property is named `$fooBar`, the "magic" method has to be
+ * > `_magicGetFooBar()`. This method is then called when `$fooBar` is read
+ * > from outside the class context.
+ *
  * @author Sebastian Meyer <sebastian.meyer@opencultureconsulting.com>
  * @package Basics\Traits
  */
@@ -40,17 +49,14 @@ trait Getter
      *
      * @return mixed The class property's current value
      *
-     * @throws InvalidArgumentException
+     * @throws InvalidArgumentException if the property does not exist
      *
      * @internal
      */
     public function __get(string $property): mixed
     {
-        $method = 'magicGet' . ucfirst($property);
+        $method = '_magicGet' . ucfirst($property);
-        if (
+        if (property_exists(static::class, $property) && method_exists(static::class, $method)) {
-            property_exists(static::class, $property)
-            && method_exists(static::class, $method)
-        ) {
             return $this->$method();
         } else {
             throw new InvalidArgumentException(

src/Traits/Setter.php

@@ -28,6 +28,15 @@ use InvalidArgumentException;
 /**
  * Writes data to inaccessible properties by using magic methods.
  *
+ * To make a `protected` or `private` property writable, provide a method named
+ * `_magicSet{Property}()` which handles the writing. Replace `{Property}` in
+ * the method's name with the name of the actual property (with an uppercase
+ * first letter).
+ *
+ * > Example: If the property is named `$fooBar`, the "magic" method has to be
+ * > `_magicSetFooBar()`. This method is then called when `$fooBar` is written
+ * > to from outside the class context.
+ *
  * @author Sebastian Meyer <sebastian.meyer@opencultureconsulting.com>
  * @package Basics\Traits
  */
@@ -41,17 +50,14 @@ trait Setter
      *
      * @return void
      *
-     * @throws InvalidArgumentException
+     * @throws InvalidArgumentException if the property does not exist
      *
      * @internal
      */
     public function __set(string $property, mixed $value): void
     {
-        $method = 'magicSet' . ucfirst($property);
+        $method = '_magicSet' . ucfirst($property);
-        if (
+        if (property_exists(static::class, $property) && method_exists(static::class, $method)) {
-            property_exists(static::class, $property)
-            && method_exists(static::class, $method)
-        ) {
             $this->$method($value);
         } else {
             throw new InvalidArgumentException(
@@ -71,8 +77,6 @@ trait Setter
      *
      * @return void
      *
-     * @throws InvalidArgumentException
-     *
      * @internal
      */
     public function __unset(string $property): void

src/Traits/Singleton.php

@@ -80,7 +80,7 @@ trait Singleton
      *
      * @return void
      *
-     * @throws LogicException
+     * @throws LogicException if trying to clone `$this`
      *
      * @internal
      */