Explicitly mark nullable parameters (#413)

Author: Tigrov

src/AbstractActiveRecord.php

@@ -720,7 +720,7 @@ public function updateProperties(array $properties): int
      * For example, to increment all customers' age by 1:
      *
      * ```php
-     * $customer = new Customer($db);
+     * $customer = new Customer();
      * $customer->updateAllCounters(['age' => 1]);
      * ```
      *
@@ -765,7 +765,7 @@ public function updateAllCounters(array $counters, array|string $condition = '',
      * An example usage is as follows:
      *
      * ```php
-     * $post = new Post($db);
+     * $post = new Post();
      * $post->updateCounters(['view_count' => 1]);
      * ```
      *
@@ -1012,7 +1012,7 @@ public function unlinkAll(string $relationName, bool $delete = false): void
     private function setRelationDependencies(
         string $name,
         ActiveQueryInterface $relation,
-        string $viaRelationName = null
+        string|null $viaRelationName = null
     ): void {
         $via = $relation->getVia();
 

src/ActiveQuery.php

@@ -731,7 +731,7 @@ public function orOnCondition(array|string $condition, array $params = []): stat
         return $this;
     }
 
-    public function viaTable(string $tableName, array $link, callable $callable = null): static
+    public function viaTable(string $tableName, array $link, callable|null $callable = null): static
     {
         $arClass = $this->primaryModel ?? $this->arClass;
 

src/ActiveQueryInterface.php

@@ -102,7 +102,7 @@ public function with(array|string ...$with): static;
      * @param callable|null $callable A PHP callback for customizing the relation associated with the junction table.
      * Its signature should be `function($query)`, where `$query` is the query to be customized.
      */
-    public function via(string $relationName, callable $callable = null): static;
+    public function via(string $relationName, callable|null $callable = null): static;
 
     /**
      * @return array|string|null the join condition to be used when this query is used in a relational context.
@@ -276,7 +276,7 @@ public function orOnCondition(array|string $condition, array $params = []): stat
      *
      * @see via()
      */
-    public function viaTable(string $tableName, array $link, callable $callable = null): static;
+    public function viaTable(string $tableName, array $link, callable|null $callable = null): static;
 
     /**
      * Define an alias for the table defined in {@see arClass}.

src/ActiveRecord.php

@@ -63,7 +63,7 @@
  * Below is an example showing some typical usage of ActiveRecord:
  *
  * ```php
- * $user = new User($db);
+ * $user = new User();
  * $user->name = 'Qiang';
  * $user->save(); // a new row is inserted into user table
  *
@@ -145,7 +145,7 @@ public function getTableSchema(): TableSchemaInterface
      *
      * ```php
      * // class Customer extends ActiveRecord
-     * $customer = new Customer($db);
+     * $customer = new Customer();
      * $customer->loadDefaultValues();
      * ```
      *
@@ -244,7 +244,7 @@ protected function propertyValuesInternal(): array
         return get_object_vars($this);
     }
 
-    protected function insertInternal(array $propertyNames = null): bool
+    protected function insertInternal(array|null $propertyNames = null): bool
     {
         $values = $this->newValues($propertyNames);
         $primaryKeys = $this->db()->createCommand()->insertWithReturningPks($this->getTableName(), $values);

src/ActiveRecordInterface.php

@@ -54,7 +54,7 @@ public function delete(): int;
      * For example, to delete all customers whose status is 3:
      *
      * ```php
-     * $customer = new Customer($db);
+     * $customer = new Customer();
      * $customer->deleteAll('status = 3');
      * ```
      *
@@ -228,7 +228,7 @@ public function hasProperty(string $name): bool;
      * For example, to insert a customer record:
      *
      * ```php
-     * $customer = new Customer($db);
+     * $customer = new Customer();
      * $customer->name = $name;
      * $customer->email = $email;
      * $customer->insert();

src/ActiveRelationTrait.php

@@ -102,7 +102,7 @@ public function __clone()
      *
      * @return static the relation object itself.
      */
-    public function via(string $relationName, callable $callable = null): static
+    public function via(string $relationName, callable|null $callable = null): static
     {
         if ($this->primaryModel === null) {
             throw new InvalidConfigException('Setting via is only supported for relational queries.');
@@ -385,8 +385,8 @@ private function populateRelationFromBuckets(
 
     private function buildBuckets(
         array $models,
-        array $viaModels = null,
-        self $viaQuery = null
+        array|null $viaModels = null,
+        self|null $viaQuery = null
     ): array {
         if ($viaModels !== null) {
             $map = [];