Search by

anovsiradj / cutter

anovsiradj

Flexible Template Library

Package info

github.com/anovsiradj/php-cutter

pkg:composer/anovsiradj/cutter

Statistics

Installs: 239

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

4.0.0 2024-06-10 01:25 UTC

This package is auto-updated.

Last update: 2026-11-18 11:04:59 UTC


README

KISS PHP Template Library.

Tested on PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5.

Installation

Download this source or via Composer:

composer require anovsiradj/cutter

Example

/index.php

require 'Cutter.php'; // directly or composer

$cutter = new anovsiradj\Cutter;
$cutter->set('layout', '/layouts/main');

$cutter->data('page_title', 'My Posts'); // set variable

$cutter->view(
	'/pages/home',
	['date_today' => date('Y-m-d')], // set variable(s)
);

/layouts/main.php

use section() / field() to output sections

<!DOCTYPE html>
<html>
	<head>
		<title><?= $page_title ?></title>
	</head>

	<body>
		<div>
			<?php $cutter->field('content') ?>
		</div>

		<?php $cutter->field('script') ?>
	</body>
</html>

/pages/home.php

use begin() and end() to output-buffer section

<?php $this->begin('content') ?>
<ul>
	<li>Post title 1</li>
	<li>Post title 2</li>
	<li>Post title 3</li>
</ul>
<?php $this->end() ?>

<?php $this->begin('script') ?>
<script>alert('date today is <?php echo $date_today ?>')</script>
<?php $this->end() ?>

for more, see /example/.

Reference

Class Methods

// Config
get( $key ) : mixed;
set( $key, mixed $val ) : void;

// Data
data( mixed $any [, mixed $val] ): mixed;        // get/set/array
dataByRef( array &$data ) : void;                // bind by reference

// View resolution
path( mixed $names ) : string|false;             // find view file (cached)
view( mixed $name [, array $data = [] [, bool $render = true ] ] ) : mixed;
render( [array $data = [] ] ) : mixed;           // render layout (cached)

// Sections
section( $name ) : bool;                         // echo section content
field( $name ) : bool;                           // alias for section()
begin( $name [, $position = 'after'] ) : void;   // start capture
end() : void;                                    // end capture
start( $name [, $position] ) : void;             // alias for begin()
open( $name [, $position] ) : void;              // alias for begin()
stop() : void;                                   // alias for end()
close() : void;                                  // alias for end()

// Introspection (v2026)
getCurrentSection() : ?string;                   // current capturing section
getCurrentPosition() : ?string;                  // current position

// Static factory
static init() : static;                          // singleton instance

// Callable helper
__invoke( $section, $callback, $position = null ) : void;

// Internal
load( $file [, bool $isob = false ] ) : mixed;

Position Values

  • after / next / 1 / n / a — append (default)
  • before / prev / previous / 0 / p / b — prepend

Performance (v2026)

  • Path resolution cached — repeated path() calls use in-memory cache
  • Layout path cached — render() resolves layout once
  • Auto-invalidation — cache cleared on relevant config changes
  • Optimized loop order — names × paths × suffixes

Development

TODO:

  • single file library / phar?
  • inheritance

All suggestions are welcome. Thanks.

Reference