Weave Code
Core Lib Laravel Package
mautic/core-lib
Core library for Mautic, the open-source marketing automation platform. Provides shared PHP classes, services, and utilities used across Mautic bundles, helping developers build and extend campaigns, contacts, segments, and integrations.
At a glance
Frequently asked questions about Core Lib
- Can I install mautic/core-lib in Laravel with Composer?
- No. mautic/core-lib is the core library for the Mautic marketing automation application, which is a standalone Symfony app, not a Laravel package. Requiring it in a Laravel project will not give you a working Mautic integration or a Laravel service provider. For Laravel, deploy Mautic separately and call its REST API.
- Is mautic/core-lib a Laravel package?
- No. It provides shared PHP classes, services, and utilities used across Mautic, a Symfony 4.4/PHP 7.4+ application with its own container, ORM, database, and web root. There are no Laravel service providers, config files, or Eloquent models in this package.
- How do I integrate Mautic with a Laravel application?
- Run Mautic as a separately deployed service and integrate over its REST API using OAuth2 or basic auth, plus inbound and outbound webhooks. On the Laravel side, wrap the API behind a MauticClient interface using mautic/api-library or a hand-rolled Guzzle client, with queue jobs, retries, and an identity mapping such as email plus a local mautic_contact_id column. Do not try to boot Mautic inside a Laravel process.
- Does mautic/core-lib support Laravel 10 or Laravel 11?
- Not applicable. mautic/core-lib is not a Laravel package and has no Laravel version constraints; its compatibility follows the Mautic release line, where Mautic 4.4 targets Symfony 4.4 and PHP 7.4/8.0. Your Laravel version only matters for the client wrapper you build.
- What PHP version does mautic/core-lib require?
- Mautic 4.4, which includes mautic/core-lib 4.4.x, targets PHP 7.4/8.0 on Symfony 4.4. If your infrastructure baseline is PHP 8.2 or newer, 4.4.x may not be a viable long-term target and you should plan against Mautic 5. Confirm your target runtime before committing to a version.
- Does mautic/core-lib include a REST API client for Laravel?
- No. mautic/core-lib is the application core, not a client SDK. For Laravel you should use mautic/api-library or your own Guzzle-based client behind an interface, so you can add retries, backoff, and queue-backed outbox behavior.
- Is mautic/core-lib safe to use in production?
- It is production code for Mautic itself, but it is not something you install standalone into Laravel. Production concerns are operational: you own a second PHP application's uptime, cron health, database backups, patching, and CVE response. The 4.4.1 patch release is low risk because it contains bug fixes only and makes no breaking API or schema changes.
- What changed in mautic/core-lib 4.4.1 and how do I upgrade?
- 4.4.1 is a maintenance release on the Mautic 4.4 line with bug fixes only, no new features, deprecations, or breaking API/schema changes. Upgrade with composer update in the Mautic root, then run doctrine:migrations:migrate and clear the cache. It does not change the REST API or webhook contract your Laravel integration depends on.
- How do I test Laravel code that talks to Mautic?
- Bind a MauticClient interface in Laravel and fake or mock it in your test suite; do not attempt to run mautic/core-lib inside Laravel tests. Use Laravel's HTTP fake or a mock Guzzle handler to simulate Mautic API responses, and post sample webhook payloads to your receiver tests. Add integration tests against a disposable Mautic instance only if you need to verify real API behavior.
- What are alternatives to mautic/core-lib for Laravel marketing automation?
- If you need marketing automation inside Laravel, evaluate hosted ESPs such as Mailchimp, SendGrid, or HubSpot, or Laravel-native notification and CRM packages, because they reduce operational surface. mautic/core-lib only makes sense when you are running the Mautic application itself. Compare the cost of owning a Mautic instance, including PHP-FPM, MySQL/MariaDB, cron, and patching, against your actual requirements before choosing.
Weaver
How can I help you explore Laravel packages today?