{"id":15025105,"url":"https://github.com/joaovdiasb/laravel-multi-tenancy","last_synced_at":"2025-04-12T13:30:30.293Z","repository":{"id":37940419,"uuid":"335338171","full_name":"joaovdiasb/laravel-multi-tenancy","owner":"joaovdiasb","description":"Laravel package for multi-tenancy database connections, providing all commands to help the life cycle of your application.","archived":true,"fork":false,"pushed_at":"2023-09-14T13:23:30.000Z","size":81,"stargazers_count":11,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-05T01:12:49.091Z","etag":null,"topics":["laravel","laravel-framework","laravel-multi-tenancy","laravel-package","multi-tenancy","multi-tenant","multi-tenants","multitenancy","multitenant","saas","tenancy","tenant"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joaovdiasb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-02T15:40:25.000Z","updated_at":"2024-10-17T16:36:21.000Z","dependencies_parsed_at":"2024-09-30T10:40:27.075Z","dependency_job_id":null,"html_url":"https://github.com/joaovdiasb/laravel-multi-tenancy","commit_stats":{"total_commits":69,"total_committers":1,"mean_commits":69.0,"dds":0.0,"last_synced_commit":"1e197d96b6bbf5e9ec6a99ff6af5c1a351c48b0c"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovdiasb%2Flaravel-multi-tenancy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovdiasb%2Flaravel-multi-tenancy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovdiasb%2Flaravel-multi-tenancy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovdiasb%2Flaravel-multi-tenancy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joaovdiasb","download_url":"https://codeload.github.com/joaovdiasb/laravel-multi-tenancy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248573369,"owners_count":21126821,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","laravel-framework","laravel-multi-tenancy","laravel-package","multi-tenancy","multi-tenant","multi-tenants","multitenancy","multitenant","saas","tenancy","tenant"],"created_at":"2024-09-24T20:01:31.545Z","updated_at":"2025-04-12T13:30:29.331Z","avatar_url":"https://github.com/joaovdiasb.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel multi-tenancy databases\n\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)\n[![CI](https://github.com/joaovdiasb/laravel-multi-tenancy/actions/workflows/run_tests.yml/badge.svg)]()\n[![Total Downloads](https://img.shields.io/packagist/dt/joaovdiasb/laravel-multi-tenancy.svg?style=flat-square)](https://packagist.org/packages/joaovdiasb/laravel-multi-tenancy)\n\n\n## Installation\n\nInstall via composer\n```bash\ncomposer require joaovdiasb/laravel-multi-tenancy\n```\n\n\n## Configuration\n\n1. Publish provider and migrate:\n```bash\nphp artisan vendor:publish --provider=\"Joaovdiasb\\LaravelMultiTenancy\\LaravelMultiTenancyServiceProvider\" \u0026\u0026 php artisan migrate --path=./database/migrations/tenant\n```\n2. Add env variable `TENANT_ENCRYPT_KEY` with 32 random characters string.\n\n\n## Usage\n\n1. Add middleware *multitenancy* on the routes that you need;\n2. Send *X-Ref* header on request with tenant reference, defined on tenants table.\n\n\n## Commands\n\n- Add tenant:\n```bash\nphp artisan tenant:add {name?} {reference?} {db_name?} {db_user?} {db_password?} {db_host?} {db_port?}\n```\n\u003e **{reference?}** Used to pass on request header to identify tenant\n\n\u003e All params are optional, if not present, will be asked on console\n\n- Migrate tenant:\n```bash\nphp artisan tenant:migrate {tenant?} {--fresh} {--seed}\n```\n\u003e **{tenant?}** Select tenant by id, if not present, all tenants are selected\n\n\u003e **{--fresh}** Is present, will drop all tables from the database\n\n\u003e **{--seed}** Is present, call seeds\n\n- Seed tenant:\n```bash\nphp artisan tenant:seed {tenant?} {--class=*}\n```\n\u003e **{tenant?}** Select tenant by id, if is not present, all tenants are selected\n\n\u003e **{--class=*}** Is required, specify class name\n\n- Backup tenant:\n```bash\nphp artisan tenant:backup {tenant?}\n```\n\u003e **{tenant?}** Select tenant by id, if is not present, all tenants are selected\n\n\n## Testing\n\nRun the tests with:\n\n```bash\nvendor/bin/phpunit\n```\n\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n\n## Security\n\nIf you discover any security-related issues, please email j.v_dias@hotmail.com instead of using the issue tracker.\n\n\n## License\n\nThe MIT License (MIT). Please see [License File](/LICENSE.md) for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaovdiasb%2Flaravel-multi-tenancy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoaovdiasb%2Flaravel-multi-tenancy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaovdiasb%2Flaravel-multi-tenancy/lists"}