Add pre-packaged source tarball for PIE

PIE doesn't handle git submodules because it downloads ZIP archives.
To work around this, create a pre-packaged source tarball that includes
the submodule contents:

- Create php_maxminddb-{version}-src.tgz from submodule ext/ directory
- Upload as GitHub release asset
- PIE automatically detects and uses this instead of ZIP
- Same approach used by MongoDB extension

References:
- php/pie#39

Author: oschwald

dev-bin/release.sh

@@ -174,6 +174,24 @@ $notes"
         exit 1
     fi
 
+    # Create pre-packaged source tarball for PIE
+    # PIE needs this because it doesn't handle git submodules automatically
+    echo "Creating pre-packaged source tarball for PIE..."
+    pie_tarball="php_maxminddb-${version}-src.tgz"
+
+    # Create tarball from the ext directory in the submodule
+    tar -czf "$pie_tarball" \
+        --transform "s|^MaxMind-DB-Reader-php/ext|php_maxminddb-${version}|" \
+        MaxMind-DB-Reader-php/ext/
+
+    if [ $? -ne 0 ]; then
+        echo "ERROR: Failed to create source tarball"
+        popd > /dev/null
+        exit 1
+    fi
+
+    echo "Created $pie_tarball"
+
     # Create corresponding release in extension repo with same tag
     echo "Creating release $tag in extension repository..."
     gh release create "$tag" \
@@ -185,7 +203,8 @@ This release tracks the $tag tag of the main repository.
 
 ## Release notes from main repository
 
-$notes"
+$notes" \
+        "$pie_tarball"
 
     if [ $? -ne 0 ]; then
         echo "ERROR: Failed to create release in extension repository"
@@ -195,9 +214,13 @@ $notes"
         exit 1
     fi
 
+    # Clean up tarball
+    rm -f "$pie_tarball"
+
     echo ""
     echo "✓ Extension repository updated successfully!"
     echo "✓ Release created: https://github.com/maxmind/MaxMind-DB-Reader-php-ext/releases/tag/$tag"
+    echo "✓ Pre-packaged source uploaded: $pie_tarball"
 fi
 
 popd > /dev/null

plan.md

@@ -3,6 +3,19 @@
 ## Overview
 Set up a new extension repository (`MaxMind-DB-Reader-php-ext`) that uses this repo as a submodule, and automate releases via `dev-bin/release.sh`.
 
+## PIE and Submodules
+
+PIE downloads source code as ZIP archives from Composer/GitHub, which don't include git submodule contents. To work around this limitation, we use PIE's built-in support for **pre-packaged source archives**:
+
+- The release script creates a tarball: `php_maxminddb-{version}-src.tgz`
+- This tarball includes the full ext/ directory from the submodule
+- It's uploaded as a GitHub release asset
+- PIE automatically detects and uses this pre-packaged source instead of the ZIP archive
+
+This is the same approach used by the MongoDB extension and others with submodule dependencies. See:
+- https://github.com/php/pie/issues/39
+- MongoDB extension implementation
+
 ## Phase 1: Create Extension Repository Structure
 
 ### 1.1 Create new repository at github.com/maxmind/MaxMind-DB-Reader-php-ext
@@ -219,6 +232,24 @@ $notes"
         exit 1
     fi
 
+    # Create pre-packaged source tarball for PIE
+    # PIE needs this because it doesn't handle git submodules automatically
+    echo "Creating pre-packaged source tarball for PIE..."
+    pie_tarball="php_maxminddb-${version}-src.tgz"
+
+    # Create tarball from the ext directory in the submodule
+    tar -czf "$pie_tarball" \
+        --transform "s|^MaxMind-DB-Reader-php/ext|php_maxminddb-${version}|" \
+        MaxMind-DB-Reader-php/ext/
+
+    if [ $? -ne 0 ]; then
+        echo "ERROR: Failed to create source tarball"
+        popd > /dev/null
+        exit 1
+    fi
+
+    echo "Created $pie_tarball"
+
     # Create corresponding release in extension repo with same tag
     echo "Creating release $tag in extension repository..."
     gh release create "$tag" \
@@ -230,7 +261,8 @@ This release tracks the $tag tag of the main repository.
 
 ## Release notes from main repository
 
-$notes"
+$notes" \
+        "$pie_tarball"
 
     if [ $? -ne 0 ]; then
         echo "ERROR: Failed to create release in extension repository"
@@ -240,9 +272,13 @@ $notes"
         exit 1
     fi
 
+    # Clean up tarball
+    rm -f "$pie_tarball"
+
     echo ""
     echo "✓ Extension repository updated successfully!"
     echo "✓ Release created: https://github.com/maxmind/MaxMind-DB-Reader-php-ext/releases/tag/$tag"
+    echo "✓ Pre-packaged source uploaded: $pie_tarball"
 fi
 
 popd > /dev/null
@@ -268,6 +304,9 @@ echo "3. Announce release"
 - Ensures on main branch
 - Verifies tag checkout succeeds
 - Only commits if there are changes
+- Creates pre-packaged source tarball with naming convention: `php_maxminddb-{version}-src.tgz`
+- Uploads tarball as GitHub release asset for PIE
+- Cleans up tarball after upload
 - Handles push/release failures gracefully
 
 ## Phase 3: Update Main Repository Documentation