PHPackages                             philip/instagres - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. philip/instagres

ActiveLibrary[Database & ORM](/categories/database)

philip/instagres
================

PHP SDK for creating instant claimable Neon PostgreSQL databases with zero configuration

v0.2.0(2mo ago)0901Apache-2.0PHPPHP >=8.1

Since Nov 12Pushed 2mo agoCompare

[ Source](https://github.com/philip/instagres-php)[ Packagist](https://packagist.org/packages/philip/instagres)[ Docs](https://neon.com)[ RSS](/packages/philip-instagres/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (4)Versions (5)Used By (1)

Neon Instagres PHP SDK
======================

[](#neon-instagres-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/319a2db6cb34a31d94436ec957a9a9376a26960b085c2ee46035df3d1506185f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69702f696e737461677265732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/philip/instagres)[![Total Downloads](https://camo.githubusercontent.com/ab13dd42c81690af8a11bff712dff7dae524b34196c8e23743690659835fcf79/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7068696c69702f696e737461677265732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/philip/instagres)

**Instagres** (Claimable Postgres) gives you a real [Neon](https://neon.com) Postgres database right away. **No account or auth.** No signup, login, or API key to create a database.

Each database runs for **72 hours** unless you **claim** it into your Neon account. After you claim, it is yours for ongoing use under your free or paid plan. Open the `claim_url` from the API when you are ready.

This package calls Neon's public [Claimable Postgres](https://neon.com/docs/reference/claimable-postgres) API at `neon.new`.

Features
--------

[](#features)

- Instant provisioning. **No Neon account or auth** to call the create API
- Connect with the returned URLs. **No Neon login** for queries (only for **claim**)
- Immediate connection string availability
- **72-hour** lifespan unless you **claim** the database for permanent use in Neon (`claim_url` in the response)
- Create a database with one method call
- Pooled and direct connection strings in the response
- `getDatabase($id)` to fetch the same resource shape as create
- Helpers for PDO parsing, claim URLs, and UUID v4 or v7
- Optional logical replication on create
- PHP 8.1+

Installation
------------

[](#installation)

```
composer require philip/instagres
```

Quick start
-----------

[](#quick-start)

```