Adds a toggle to allow shape files with no dbf

psalm-baseline.xml

@@ -21,7 +21,6 @@
       <code><![CDATA[$this->records[$index]->getContentLength()]]></code>
     </PossiblyNullOperand>
     <PossiblyUnusedReturnValue>
-      <code><![CDATA[bool]]></code>
       <code><![CDATA[bool]]></code>
       <code><![CDATA[int]]></code>
     </PossiblyUnusedReturnValue>

src/ShapeFile.php

@@ -27,6 +27,11 @@
 
 use function chr;
 use function count;
+use function dbase_close;
+use function dbase_create;
+use function dbase_delete_record;
+use function dbase_open;
+use function dbase_pack;
 use function extension_loaded;
 use function fclose;
 use function feof;
@@ -76,6 +81,8 @@
     /** @var array<int, ShapeRecord> */
     public array $records = [];
 
+    private bool $allowNoDbf = false;
+
     /**
      * Checks whether dbase manipulations are supported.
      */
@@ -101,6 +108,11 @@
     ) {
     }
 
+    public function setAllowNoDbf(bool $allowNoDbf): void
+    {
+        $this->allowNoDbf = $allowNoDbf;
+    }
+
     /**
      * Loads shapefile and dbase (if supported).
      *
@@ -613,6 +625,10 @@
 
         $dbfName = $this->getFilename('.dbf');
         if (! is_readable($dbfName)) {
+            if ($this->allowNoDbf) {
+                return true;
+            }
+
             $this->setError(sprintf('It wasn\'t possible to find the DBase file "%s"', $dbfName));
 
             return false;
@@ -654,7 +670,7 @@
      *
      * @param int<0, max> $bytes
      */
     public function readSHP(int $bytes): string|false
     {
         if ($this->shpFile === false) {
             return false;

src/ShapeRecord.php

@@ -27,6 +27,10 @@
 
 use function array_values;
 use function count;
+use function dbase_add_record;
+use function dbase_get_record_with_names;
+use function dbase_numrecords;
+use function dbase_replace_record;
 use function fwrite;
 use function in_array;
 use function is_array;

tests/ShapeFileTest.php

@@ -418,4 +418,15 @@ public function testSearch(): void
             $shp->getIndexFromDBFData('CNTRY_NAME', 'Czech Republic'),
         );
     }
+
+    public function testAllowsNoDbf(): void
+    {
+        if (! ShapeFile::supportsDbase()) {
+            self::markTestSkipped();
+        }
+
+        $shp = new ShapeFile(ShapeType::Null);
+        $shp->setAllowNoDbf(true);
+        self::assertTrue($shp->loadFromFile('data/no-dbf.*'));
+    }
 }