Weave Code
Neo4J Php Client Laravel Package
plumtreesystems/neo4j-php-client
A PHP client for Neo4j graph databases with Bolt and HTTP connections, transaction support, flexible result handling, and an expressive query API. Works well in PHP and Laravel applications that need reliable graph database access.
PHP Client for Neo4j with Enterprise Support
Frequently asked questions about Neo4J Php Client
- How do I install plumtreesystems/neo4j-php-client?
- Install it with Composer using composer require plumtreesystems/neo4j-php-client. You will still need a reachable Neo4j instance and connection credentials, typically supplied through environment variables or your app config. Check the repository README for the exact PHP version and driver requirements before installing.
- Does this Neo4j client work with Laravel?
- Yes, it is a PHP client that can be used inside Laravel applications, but the provided overview does not describe automatic Laravel package discovery, a facade, or a published config file. In Laravel you would typically bind a configured client in a service provider and read Neo4j connection settings from config or env. Confirm any Laravel-specific integration and version constraints in the repository before relying on it.
- Which Neo4j versions are supported by this package?
- The 5.0.0 release note in the provided context says support for Neo4j 3.5+ and 4.0. That does not confirm Neo4j 5.x support, so verify the current README and Composer constraints before adopting. If your cluster runs Neo4j 5.x, treat version support as a blocking check.
- Should I use Bolt or HTTP for Neo4j connections?
- Bolt is the native binary protocol for Neo4j drivers and is usually preferred for application queries; HTTP can be simpler when network or tooling constraints favor REST. This client supports both, so the choice depends on your deployment and security model. Verify TLS, routing, and driver requirements for your Neo4j version.
- How do I run a Cypher query with parameters?
- Use the client's fluent query execution and pass Cypher parameters as bound values instead of concatenating strings. For example, pass an associative array of parameters and reference them in Cypher with placeholders. This improves reuse and reduces Cypher injection risk.
- How do I commit or roll back a Neo4j transaction?
- Start a transaction through the client, execute your Cypher statements, then commit on success or roll back on failure. The client supports commit and rollback semantics, but it cannot provide two-phase commit across Neo4j and a relational database. If you dual-write, design an outbox or reconciliation process rather than assuming a Laravel transaction covers both stores.
- How do I fetch and hydrate query results?
- The client exposes result cursors and hydration helpers. You can iterate the cursor and map rows into arrays or objects according to the helper you use. Check the README for the exact hydration methods and cursor behavior.
- Is this an OGM with models and migrations, or a raw Cypher client?
- Based on the provided overview, it is a Cypher client with transactions and result helpers, not an Eloquent-style OGM. The description does not list model classes, relationship mapping, or schema migration tooling. If you need an OGM or migration system, verify whether the package includes one or plan to manage Neo4j schema separately.
- How do I test and run this Neo4j client in production?
- Test against a real Neo4j instance or a containerized Neo4j rather than mocking Cypher heavily, because query semantics and result shapes are database behavior. In production, pin the package and Neo4j versions, monitor the separate Neo4j datastore, and account for eventual consistency if you dual-write with a relational system of record. The client does not remove the need for Neo4j backups, access control, or Cypher skills.
- Is plumtreesystems/neo4j-php-client maintained, and what are the alternatives?
- The provided context does not include release cadence, open issue counts, or a changelog, so maintenance status must be checked on the repository. The official Neo4j PHP driver is the lower-level alternative; this package adds a higher-level client API over Bolt and HTTP. Compare current Neo4j version support and Laravel integration needs before choosing.
Weaver
How can I help you explore Laravel packages today?