feat: add TextArrayType

Author: Eugene Fureev

CHANGELOG.md

@@ -9,6 +9,12 @@ Check MD [online][check-online].
 
 ## [unreleased]
 
+## [2.1.0] - 2024-07-22
+
+### Added
+
+- Add `TextArrayType`
+
 ## [2.0.0] - 2024-03-13
 
 ### Added

readme.md

@@ -29,6 +29,7 @@ composer require efureev/laravel-support-db "^2.0"
     - [XML](#xml)
     - [Array of UUID](#array-of-uuid)
     - [Array of Integer](#array-of-integer)
+    - [Array of Text](#array-of-text)
 - [Column Options](#column-options)
     - [Compression](#compression)
 - [Views](#views)
@@ -159,6 +160,14 @@ The array of integer data type can be used to store a list of integers.
 $table->intArray(string $column);
 ```
 
+#### Array of Text
+
+The array of text data type can be used to store a list of string.
+
+```php
+$table->textArray(string $column);
+```
+
 ### Column Options
 
 #### Compression

src/Schema/Postgres/Blueprint.php

@@ -137,6 +137,14 @@ public function uuidArray(string $column): ColumnDefinition
         return $this->addColumn('uuidArray', $column);
     }
 
+    /**
+     * Create a new text[] column
+     */
+    public function textArray(string $column): ColumnDefinition
+    {
+        return $this->addColumn('textArray', $column);
+    }
+
     /**
      * Create a new int[] column
      *

src/Schema/Postgres/Grammar/GrammarTypes.php

@@ -11,6 +11,7 @@
 use Php\Support\Laravel\Database\Schema\Postgres\Types\IntArrayType;
 use Php\Support\Laravel\Database\Schema\Postgres\Types\IpNetworkType;
 use Php\Support\Laravel\Database\Schema\Postgres\Types\NumericType;
+use Php\Support\Laravel\Database\Schema\Postgres\Types\TextArrayType;
 use Php\Support\Laravel\Database\Schema\Postgres\Types\TsRangeType;
 use Php\Support\Laravel\Database\Schema\Postgres\Types\UuidArrayType;
 use Php\Support\Laravel\Database\Schema\Postgres\Types\XmlType;
@@ -48,6 +49,11 @@ protected function typeUuidArray(ColumnDefinition $column): string
         return UuidArrayType::TYPE_NAME;
     }
 
+    protected function typeTextArray(ColumnDefinition $column): string
+    {
+        return TextArrayType::TYPE_NAME;
+    }
+
     protected function typeIntArray(ColumnDefinition $column): string
     {
         return IntArrayType::TYPE_NAME;

src/Schema/Postgres/Types/TextArrayType.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Php\Support\Laravel\Database\Schema\Postgres\Types;
+
+class TextArrayType extends AbstractType
+{
+    public const TYPE_NAME = 'text[]';
+
+    public function phpType(): string
+    {
+        return 'text[]';
+    }
+
+    public function postgresType(): string
+    {
+        return 'ARRAY';
+    }
+}

tests/Functional/Types/ArrayOfTextTest.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Functional\Types;
+
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Php\Support\Laravel\Database\Schema\Postgres\Blueprint;
+use Php\Support\Laravel\Database\Schema\Postgres\Types\TextArrayType;
+use Php\Support\Laravel\Database\Schema\Postgres\Types\UuidArrayType;
+use Php\Support\Laravel\Database\Tests\AbstractTestCase;
+use Php\Support\Laravel\Database\Tests\Helpers\ColumnAssertions;
+use Php\Support\Laravel\Database\Tests\Helpers\IndexAssertions;
+use PHPUnit\Framework\Attributes\Test;
+
+class ArrayOfTextTest extends AbstractTestCase
+{
+    use ColumnAssertions;
+    use IndexAssertions;
+
+    #[Test]
+    public function base(): void
+    {
+        Schema::create(
+            'test_table',
+            static function (Blueprint $table) {
+                $table->increments('id');
+                $table->textArray('test_col');
+                $table->ginIndex('test_col');
+            }
+        );
+
+        static::assertTrue(Schema::hasTable('test_table'));
+        $this->seeIndex('test_table_test_col_index');
+
+        $definition = DB::selectOne('SELECT * FROM pg_indexes WHERE indexname = ?', ['test_table_test_col_index']);
+
+        self::assertEquals(
+            "CREATE INDEX test_table_test_col_index ON public.test_table USING gin (test_col)",
+            $definition->indexdef
+        );
+
+        $this->assertTypeColumn('test_table', 'test_col', TextArrayType::class);
+    }
+
+}