包简介

PHP Template Engine for the Lighthouse framework

README 文档

README

A simple, powerful PHP template engine for the Lighthouse framework.

Installation

composer require lighthouse/view

Requirements

PHP 8.2 or higher

Features

PHP-based templates (no new syntax to learn)
Layouts with sections
Partials/includes
Automatic HTML escaping
Global shared data
Dot notation for view paths

Quick Start

Basic Rendering

use Lighthouse\View\View;

$view = new View('/path/to/views');

// Render a view
echo $view->render('welcome', ['name' => 'John']);

views/welcome.php:

<h1>Hello, <?= $view->e($name) ?>!</h1>

Escaping

Always escape user data to prevent XSS attacks:

// In templates, use $view->e() or $view->escape()
<p><?= $view->e($userInput) ?></p>

// For JSON (e.g., in JavaScript)
<script>
    var data = <?= $view->json($data) ?>;
</script>

Layouts

Create a layout template:

views/layouts/main.php:

<!DOCTYPE html>
<html>
<head>
    <title><?= $view->yield('title', 'My App') ?></title>
</head>
<body>
    <header>
        <?= $view->yield('header') ?>
    </header>
    
    <main>
        <?= $view->yield('content') ?>
    </main>
    
    <footer>© 2025</footer>
</body>
</html>

Extend the layout in your view:

views/users/index.php:

<?php $view->extends('layouts.main'); ?>

<?php $view->section('title'); ?>
Users List
<?php $view->endSection(); ?>

<?php $view->section('content'); ?>
<h1>Users</h1>
<ul>
    <?php foreach ($users as $user): ?>
        <li><?= $view->e($user['name']) ?></li>
    <?php endforeach; ?>
</ul>
<?php $view->endSection(); ?>

Partials

Include reusable components:

views/partials/alert.php:

<div class="alert alert-<?= $view->e($type) ?>">
    <?= $view->e($message) ?>
</div>

Usage:

<?php $view->include('partials.alert', ['type' => 'success', 'message' => 'Saved!']); ?>

Or capture the output:

$html = $view->partial('partials.alert', ['type' => 'error', 'message' => 'Failed']);

Shared Data

Share data across all views:

// Share single value
$view->share('appName', 'My Application');

// Share multiple values
$view->share([
    'appName' => 'My Application',
    'version' => '1.0.0',
    'user' => $currentUser,
]);

Access in any template:

<title><?= $view->e($appName) ?></title>

Dot Notation

View paths use dot notation:

$view->render('users.index');      // views/users/index.php
$view->render('admin.users.edit'); // views/admin/users/edit.php
$view->partial('partials.nav');    // views/partials/nav.php

Check View Exists

if ($view->exists('emails.welcome')) {
    echo $view->render('emails.welcome', $data);
}

API Reference

View

Method	Description
`render(string $view, array $data)`	Render a view template
`partial(string $partial, array $data)`	Render and return a partial
`include(string $partial, array $data)`	Render and echo a partial
`extends(string $layout)`	Set layout for current view
`section(string $name)`	Start capturing a section
`endSection()`	End section capture
`yield(string $name, string $default)`	Output section content
`hasSection(string $name)`	Check if section exists
`share(string\|array $key, mixed $value)`	Share data globally
`getShared(?string $key)`	Get shared data
`escape(string $value)`	Escape HTML entities
`e(string $value)`	Alias for escape()
`json(mixed $value)`	Safe JSON encoding
`exists(string $view)`	Check if view file exists
`getBasePath()`	Get views base path
`setBasePath(string $path)`	Set views base path

Template Variables

Inside templates, these variables are available:

$view - The View instance (for helpers)
Any data passed to render() or partial()
Any globally shared data

Testing

composer test

License

MIT License. See LICENSE for details.

Part of the Lighthouse Framework

This package is part of the Lighthouse Framework, an educational PHP framework designed to teach how modern frameworks work internally.

lighthouse/view 适用场景与选型建议

lighthouse/view 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 11 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 12 月 17 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「templating」「php」「template」「view」「lighthouse」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 lighthouse/view 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 lighthouse/view 我们能提供哪些服务？

定制开发 / 二次开发

基于 lighthouse/view 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 lighthouse/view 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

shoot/shoot 40

Shoot aims to make providing data to your templates more manageable

ouxsoft/phpmarkup 0

A Processor for Markup written in PHP. Allows extraction of Markup into a data structure, orchestrated nested manipulation of said structure, and output as (optimized) Markup.

gurubob/ascii-table 2

Simple ASCII output of array data

e2es/blade 0

E2E Studios PHP Framework adaptation of leafsphp/blade package

melisplatform/melis-templating-plugin-creator 1

Melis Platform Templating Plugin Creator

mcsodbrenner/serpent 3

Serpent is a lightweight and compiling templating engine for PHP. It was designed to seamlessly integrate into existing MVC frameworks. It uses PHP itself as its template language, so you do not need to learn a new markup language. On the other side you get many improvements compared to pure PHP.

lighthouse/view

包简介

关键字：