Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jenstornell/squid
A PHP MySQL query tester
https://github.com/jenstornell/squid
mysql php query rows select sql tester
Last synced: 13 days ago
JSON representation
A PHP MySQL query tester
- Host: GitHub
- URL: https://github.com/jenstornell/squid
- Owner: jenstornell
- Created: 2019-01-05T09:15:12.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-12T21:32:09.000Z (about 6 years ago)
- Last Synced: 2024-01-14T08:12:15.101Z (about 1 year ago)
- Topics: mysql, php, query, rows, select, sql, tester
- Language: PHP
- Homepage:
- Size: 262 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
Awesome Lists containing this project
README
# Squid
*Version 1.1*
A PHP MySQL query tester.
## Squid vs phpMyAdmin
phpMyAdmin is a big tool with lots of stuff. Squid is only made for testing SQL queries. In the table below I will compare Squid to the SQL tab in phpMyAdmin.
| Feature | Squid | phpMyAdmin |
| ---------------------------------- |:------------------:|:------------------:|
| Ajax driven | :heavy_check_mark: | :heavy_check_mark: |
| Latest query saved | :heavy_check_mark: | :warning: |
| Textarea autosize | :heavy_check_mark: | :warning: |
| Query and results on the same page | :heavy_check_mark: | :warning: |
| Format query | :heavy_check_mark: | :heavy_check_mark: |
| Create query with buttons | :x: | :heavy_check_mark: |
| Row counter | :heavy_check_mark: | :heavy_check_mark: |
| Fixed scrollbar and table headings | :heavy_check_mark: | :heavy_check_mark: |
| No bloat | :heavy_check_mark: | :x: |
| Login | :x: | :heavy_check_mark: |
| Mobile friendly | :x: | :x: |
## Setup
Place the files on a server with PHP7+ and MySQL.
**BE AWARE: There is no login so put it on a localhost server or use a htpasswd file.**
### 1. Database
Add a file called `setup.php` in the root and setup your database like below.
```php
[
'name' => 'database_name',
'user' => 'root',
'pass' => '',
'host' => 'localhost',
'charset' => 'utf8mb4' // Optional
]
]);
```
## Usage
### Query form
Write or paste an SQL query. Click the button to run the query.
- The textarea will autosize when writing.
- Only SELECT queries are allowed by default.
- The query will be saved to disk and loaded again on refresh.
### Format SQL
Maybe you need a formatted SQL query with syntax highlighting. Here you can get it.
### Affected rows
A row counter of found rows.
### Table
If the SQL query is valid the data will be displayed as a table. I recommend to use `LIMIT`, else it will be slow with many rows.
Hold down `ALT` and double click on a table data cell to see the full content of that cell.
## Options
You can add options to `setup.php` placed in the root.
### cell_max_width
In some cases database rows can be very long. To prevent that you can set `cell_max_width` to something like `200`, which will be 200 pixels.
If you want to see a particular value again, you can hover the table cell to get a tooltip.
```php
option::set([
'cell_max_width' => 200
]);
```
### select_only
To prevent data loss by accident, only `SELECT` queries are allowed. At own risk you can disable it by setting it to `false`.
**BE AWARE: This will not protect you against abuse. You can still use subqueries with DELETE or UPDATE actions.**
```php
option::set([
'select_only' => true
]);
```
## Requirements
- PHP7
- ES6 supported browser like Google Chrome
## Libraries used
- https://github.com/jdorn/sql-formatter
- https://github.com/jackmoore/autosize
- https://github.com/jenstornell/TinyOptions
- https://github.com/cferdinandi/modals
## Disclaimer
Use at own risk! There is no login.
## Donate
Donate to [DevoneraAB](https://www.paypal.me/DevoneraAB) if you want.
## License
MIT