{"id":18010805,"url":"https://github.com/guanguans/laravel-dump-sql","last_synced_at":"2025-04-12T14:40:28.744Z","repository":{"id":43106440,"uuid":"276298649","full_name":"guanguans/laravel-dump-sql","owner":"guanguans","description":"Assist laravel application to obtain complete sql statement. - 辅助 laravel 应用获取完整的 sql 语句。 ","archived":false,"fork":false,"pushed_at":"2024-07-09T21:10:37.000Z","size":2879,"stargazers_count":36,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T01:49:02.138Z","etag":null,"topics":["dump","laravel","mysql","sql"],"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/guanguans.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"guanguans","custom":"https://www.guanguans.cn/images/wechat.jpeg"}},"created_at":"2020-07-01T06:44:37.000Z","updated_at":"2024-11-29T02:08:16.000Z","dependencies_parsed_at":"2023-12-08T02:28:33.959Z","dependency_job_id":"aeb19420-952d-458a-94bb-e59c1727e2c2","html_url":"https://github.com/guanguans/laravel-dump-sql","commit_stats":{"total_commits":125,"total_committers":5,"mean_commits":25.0,"dds":"0.43200000000000005","last_synced_commit":"db285d57b56d2f0601474e95ad695a0e7c02f948"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanguans%2Flaravel-dump-sql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanguans%2Flaravel-dump-sql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanguans%2Flaravel-dump-sql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanguans%2Flaravel-dump-sql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guanguans","download_url":"https://codeload.github.com/guanguans/laravel-dump-sql/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248582312,"owners_count":21128355,"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":["dump","laravel","mysql","sql"],"created_at":"2024-10-30T02:15:24.037Z","updated_at":"2025-04-12T14:40:28.726Z","avatar_url":"https://github.com/guanguans.png","language":"PHP","readme":"# laravel-dump-sql\n\n![](docs/dump-server.gif)\n\n[![tests](https://github.com/guanguans/laravel-dump-sql/workflows/tests/badge.svg)](https://github.com/guanguans/laravel-dump-sql/actions)\n[![check \u0026 fix styling](https://github.com/guanguans/laravel-dump-sql/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/guanguans/laravel-dump-sql/actions)\n[![codecov](https://codecov.io/gh/guanguans/laravel-dump-sql/graph/badge.svg?token=KJTIGSKD0D)](https://codecov.io/gh/guanguans/laravel-dump-sql)\n[![Latest Stable Version](https://poser.pugx.org/guanguans/laravel-dump-sql/v)](//packagist.org/packages/guanguans/laravel-dump-sql)\n[![Total Downloads](https://poser.pugx.org/guanguans/laravel-dump-sql/downloads)](//packagist.org/packages/guanguans/laravel-dump-sql)\n[![License](https://poser.pugx.org/guanguans/laravel-dump-sql/license)](//packagist.org/packages/guanguans/laravel-dump-sql)\n\n\u003e Assist laravel application to obtain complete sql statement. - 辅助 laravel 应用获取完整的 sql 语句。\n\n\u003e The sql statement obtained by the query construction method in laravel is not bound to the conditional parameters, similar to `select * from users where id= ?`. This expansion pack can help you get a complete sql statement. - laravel 中查询构造方法得到的 sql 语句没有绑定条件参数，类似于`select * from users where id= ?`。这个扩展包可辅助你获取完整的 sql 语句。\n\n## 功能\n\n* 添加获取 sql 语句的查询构建便捷方法(`toRawSql`、`dumpSql`、`ddSql`、`logListenedSql`、`dumpListenedSql`、`ddListenedSql`)\n* 添加监控 sql 语句的服务命令\n\n## 环境要求\n\n* laravel || lumen \u003e= 6.10\n\n## 安装\n\n```shell\n$ composer require guanguans/laravel-dump-sql -v\n```\n\n### lumen 中配置(laravel 中请忽略)\n\n将下面代码添加到 `bootstrap/app.php` 文件中的 `Register Service Providers` 部分\n\n```php\n$app-\u003eregister(\\Guanguans\\LaravelDumpSql\\ServiceProvider::class);\n```\n\n## 使用\n\n### 监控 sql 语句的服务的使用\n\n```shell\n$ php artisan server:dump-sql\n```\n\n![](docs/dump-server.png)\n\n### 获取 sql 语句的查询构建便捷方法的使用\n\n安装配置完毕后数据库查询构造方法会新增以下几个方法：\n\n* toRawSql() - 获取完整的 sql\n* dumpSql() - 打印完整的 sql\n* ddSql() - 打印完整的 sql 并且退出\n* logListenedSql() - 记录被监听到的 sql\n* dumpListenedSql() - 打印被监听到的 sql\n* ddListenedSql() - 打印被监听到的 sql 并且退出\n\n#### toRawSql() - 获取完整的 sql\n\n```php\n$sql = User::query()-\u003ewhere('id', 1)-\u003etoRawSql();\ndd($sql);\n```\n\n```sql\n\"select * from `xb_users` where `id` = 1\"\n```\n\n#### dumpSql() - 打印完整的 sql\n\n```php\nUser::query()-\u003ewhere('id', 1)-\u003edumpSql();\nUser::query()-\u003ewhere('id', 2)-\u003edumpSql();\n```\n\n```sql\n\"select * from `xb_users` where `id` = 1\"\n\"select * from `xb_users` where `id` = 2\"\n```\n\n#### ddSql() - 打印完整的 sql 并且退出\n\n```php\nUser::query()-\u003ewhere('id', 1)-\u003eddSql();\nUser::query()-\u003ewhere('id', 2)-\u003eddSql();\n```\n\n```sql\n\"select * from `xb_users` where `id` = 1\"\n```\n\n#### logListenedSql() - 记录被监听到的 sql\n\n```php\nUser::query()-\u003ewhere('id', 1)-\u003elogListenedSql()-\u003efirst();\nUser::query()-\u003ewhere('id', 2)-\u003efirst();\n```\n\n```shell\n# 日志中\n[Laravel] [39.97ms] select * from `xb_users` where `id` = '1' limit 1 | GET: /\n[Laravel] [39.93ms] select * from `xb_users` where `id` = '2' limit 1 | GET: /\n```\n\n#### dumpListenedSql() - 打印被监听到的 sql\n\n```php\nUser::query()-\u003ewhere('id', 1)-\u003edumpListenedSql()-\u003efirst();\nUser::query()-\u003ewhere('id', 2)-\u003efirst();\n```\n\n```shell\n[Laravel] [39.97ms] select * from `xb_users` where `id` = '1' limit 1 | GET: /\n[Laravel] [39.93ms] select * from `xb_users` where `id` = '2' limit 1 | GET: /\n```\n\n#### ddListenedSql() - 打印被监听到的 sql 并且退出\n\n```php\nUser::query()-\u003ewhere('id', 1)-\u003eddListenedSql()-\u003efirst();\nUser::query()-\u003ewhere('id', 2)-\u003efirst();\n```\n\n```shell\n[Laravel] [39.97ms] select * from `xb_users` where `id` = '1' limit 1 | GET: /\n```\n\n## 安全漏洞\n\n请查看[我们的安全政策](../../security/policy)了解如何报告安全漏洞。\n\n## 贡献者\n\n* [guanguans](https://github.com/guanguans)\n* [所有贡献者](../../contributors)\n\n## 协议\n\nMIT 许可证（MIT）。有关更多信息，请参见[协议文件](LICENSE)。\n","funding_links":["https://patreon.com/guanguans","https://www.guanguans.cn/images/wechat.jpeg"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguanguans%2Flaravel-dump-sql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguanguans%2Flaravel-dump-sql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguanguans%2Flaravel-dump-sql/lists"}