-
-
Notifications
You must be signed in to change notification settings - Fork 45
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch '3.0.x' into 2.35.x-merge-up-into-3.0.x_ycpcjD6g
# Conflicts: # composer.lock # psalm-baseline.xml # src/Helper/Json.php # src/Renderer/PhpRenderer.php # test/Helper/JsonTest.php
- Loading branch information
Showing
65 changed files
with
5,273 additions
and
2,224 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,210 @@ | ||
| # Stand-Alone | ||
|
|
||
| The view and all view-helpers of laminas-view can also be used stand-alone. | ||
|
|
||
| ## The View | ||
|
|
||
| The examples uses the following directory structure: | ||
|
|
||
| ```treeview | ||
| ./ | ||
| |-- public/ | ||
| | `-- index.php | ||
| `-- templates/ | ||
| |-- index.phtml | ||
| `-- layout.phtml | ||
| ``` | ||
|
|
||
| ### Basic Example | ||
|
|
||
| #### Setup | ||
|
|
||
| [Create a renderer, set a resolver for templates](../php-renderer.md#usage) | ||
| and initialize the view in `public/index.php`: | ||
|
|
||
| ```php | ||
| // Create template resolver | ||
| $templateResolver = new Laminas\View\Resolver\TemplatePathStack([ | ||
| 'script_paths' => [__DIR__ . '/../templates'], | ||
| ]); | ||
|
|
||
| // Create the renderer | ||
| $renderer = new Laminas\View\Renderer\PhpRenderer(); | ||
| $renderer->setResolver($templateResolver); | ||
|
|
||
| // Initialize the view | ||
| $view = new Laminas\View\View(); | ||
| $view->getEventManager()->attach( | ||
| Laminas\View\ViewEvent::EVENT_RENDERER, | ||
| static function () use ($renderer) { | ||
| return $renderer; | ||
| } | ||
| ); | ||
| ``` | ||
|
|
||
| #### Create View Script | ||
|
|
||
| [Create a view script](../view-scripts.md) in `templates/index.phtml`: | ||
|
|
||
| ```php | ||
| <?php | ||
| /** | ||
| * @var Laminas\View\Renderer\PhpRenderer $this | ||
| * @var string $headline | ||
| */ | ||
| ?> | ||
| <h1><?= $headline ?></h1> | ||
| ``` | ||
|
|
||
| #### Create View Model and render Output | ||
|
|
||
| Extend the script in `public/index.php` to add a [view model](../quick-start.md): | ||
|
|
||
| ```php | ||
| $viewModel = new Laminas\View\Model\ViewModel(['headline' => 'Example']); | ||
| $viewModel->setTemplate('index'); | ||
|
|
||
| // Set the return type to get the rendered content | ||
| $viewModel->setOption('has_parent', true); | ||
|
|
||
| echo $view->render($viewModel); // <h1>Example</h1> | ||
| ``` | ||
| <!-- markdownlint-disable-next-line no-inline-html --> | ||
| <details><summary>Show full code example</summary> | ||
|
|
||
| ```php | ||
| <?php | ||
|
|
||
| require_once __DIR__ . '/../vendor/autoload.php'; | ||
|
|
||
| // Create template resolver | ||
| $templateResolver = new Laminas\View\Resolver\TemplatePathStack([ | ||
| 'script_paths' => [__DIR__ . '/../templates'], | ||
| ]); | ||
|
|
||
| // Create the renderer | ||
| $renderer = new Laminas\View\Renderer\PhpRenderer(); | ||
| $renderer->setResolver($templateResolver); | ||
|
|
||
| // Initialize the view | ||
| $view = new Laminas\View\View(); | ||
| $view->getEventManager()->attach( | ||
| Laminas\View\ViewEvent::EVENT_RENDERER, | ||
| static function () use ($renderer) { | ||
| return $renderer; | ||
| } | ||
| ); | ||
|
|
||
| // Create view model | ||
| $viewModel = new Laminas\View\Model\ViewModel(['headline' => 'Example']); | ||
| $viewModel->setTemplate('index'); | ||
|
|
||
| // Set the return type to get the rendered content | ||
| $viewModel->setOption('has_parent', true); | ||
|
|
||
| // Render | ||
| echo $view->render($viewModel); | ||
| ``` | ||
|
|
||
| <!-- markdownlint-disable-next-line no-inline-html --> | ||
| </details> | ||
|
|
||
| ### Example with Layout | ||
|
|
||
| #### Add Layout Script | ||
|
|
||
| Create a new file `templates/layout.phtml` and add the following content: | ||
|
|
||
| ```php | ||
| <?php | ||
| /** | ||
| * @var Laminas\View\Renderer\PhpRenderer $this | ||
| * @var string $content | ||
| */ | ||
| ?> | ||
| <body> | ||
| <?= $content ?> | ||
| </body> | ||
| ``` | ||
|
|
||
| #### Create Layout Model and render Output | ||
|
|
||
| Update the script in `public/index.php` to add a view model for layout: | ||
|
|
||
| ```php | ||
| // Create layout model | ||
| $layout = new Laminas\View\Model\ViewModel(); | ||
| $layout->setTemplate('layout'); | ||
|
|
||
| // Set the return type to get the rendered content | ||
| $layout->setOption('has_parent', true); | ||
|
|
||
| // Add previous view model as child | ||
| $layout->addChild($viewModel); | ||
|
|
||
| // Render | ||
| echo $view->render($layout); | ||
| ``` | ||
|
|
||
| <!-- markdownlint-disable-next-line no-inline-html --> | ||
| <details><summary>Show full code example</summary> | ||
|
|
||
| ```php | ||
| <?php | ||
|
|
||
| require_once __DIR__ . '/../vendor/autoload.php'; | ||
|
|
||
| // Create template resolver | ||
| $templateResolver = new Laminas\View\Resolver\TemplatePathStack([ | ||
| 'script_paths' => [__DIR__ . '/../templates'], | ||
| ]); | ||
|
|
||
| // Create the renderer | ||
| $renderer = new Laminas\View\Renderer\PhpRenderer(); | ||
| $renderer->setResolver($templateResolver); | ||
|
|
||
| // Initialize the view | ||
| $view = new Laminas\View\View(); | ||
| $view->getEventManager()->attach( | ||
| Laminas\View\ViewEvent::EVENT_RENDERER, | ||
| static function () use ($renderer) { | ||
| return $renderer; | ||
| } | ||
| ); | ||
|
|
||
| // Create view model | ||
| $viewModel = new Laminas\View\Model\ViewModel(['headline' => 'Example']); | ||
| $viewModel->setTemplate('index'); | ||
|
|
||
| // Create layout model | ||
| $layout = new Laminas\View\Model\ViewModel(); | ||
| $layout->setTemplate('layout'); | ||
|
|
||
| // Set the return type to get the rendered content | ||
| $layout->setOption('has_parent', true); | ||
|
|
||
| // Add previous view model as child | ||
| $layout->addChild($viewModel); | ||
|
|
||
| // Render | ||
| echo $view->render($layout); | ||
| ``` | ||
|
|
||
| <!-- markdownlint-disable-next-line no-inline-html --> | ||
| </details> | ||
|
|
||
| ## View Helpers | ||
|
|
||
| ### Setup | ||
|
|
||
| Create the renderer: | ||
|
|
||
| ```php | ||
| $renderer = new Laminas\View\Renderer\PhpRenderer(); | ||
| ``` | ||
|
|
||
| ### Using Helper | ||
|
|
||
| ```php | ||
| echo $renderer->doctype(Laminas\View\Helper\Doctype::HTML5); // <!DOCTYPE html> | ||
| ``` |
Oops, something went wrong.