Load and manage SQL queries from files

1.5.1 2024-06-10 03:13 UTC

This package is auto-updated.

Last update: 2024-06-10 03:32:30 UTC


Scrutinizer Code Quality codecov Continuous Integration

Koriym.QueryLocator is a PHP library that helps you manage SQL queries by locating and loading them from the file system. This approach simplifies query management and enhances code readability.


Install the library using Composer:

$ composer require koriym/query-locator


Basic Example

To use the QueryLocator class, instantiate it with the directory where your SQL files are stored. You can then retrieve queries using keys that correspond to the directory structure.

SQL Files Directory Structure

└── sql
    └── admin
        └── user.sql

Code Example

use Koriym\QueryLocator\QueryLocator;

// Define the directory where your SQL files are stored
$sqlDir = 'path/to/sql/files';

// Instantiate the QueryLocator
$query = new QueryLocator($sqlDir);

// Retrieve a query
$sql = $query['admin/user']; // This will load the contents of 'admin/user.sql'

// Retrieve a count query
$countSql = $query->getCountQuery('admin/user'); // This will generate 'SELECT COUNT(*) FROM user'


  • File-Based Query Management: Store your SQL queries in separate files for better organization.
  • Simple Query Retrieval: Use directory-based keys to retrieve queries.
  • Count Query Generation: Automatically generate count queries.


  • Improved Readability: Keep your PHP code clean and readable by moving SQL queries to dedicated files.
  • Easy Maintenance: Modify your SQL queries without changing the PHP code, just update the SQL files.
  • Structured Organization: Organize your queries in a directory structure that makes sense for your application.