viewfile php,View.php

namespace Illuminate\View;

use Exception;

use Throwable;

use ArrayAccess;

use BadMethodCallException;

use Illuminate\Support\Str;

use Illuminate\Support\MessageBag;

use Illuminate\Contracts\Support\Arrayable;

use Illuminate\View\Engines\EngineInterface;

use Illuminate\Contracts\Support\Renderable;

use Illuminate\Contracts\Support\MessageProvider;

use Illuminate\Contracts\View\View as ViewContract;

// namespace about the view

class View implements ArrayAccess, ViewContract

{// class view implements arrayAccess,ViewContact

/**

* The view factory instance.

*

* @var \Illuminate\View\Factory

*/

protected $factory;//The view factory instance.

/**

* The engine implementation.

*

* @var \Illuminate\View\Engines\EngineInterface

*/

protected $engine;//The engine implementation

/**

* The name of the view.

*

* @var string

*/

protected $view;//The name of the view.

/**

* The array of view data.

*

* @var array

*/

protected $data;//The array of view data.

/**

* The path to the view file.

*

* @var string

*/

protected $path;//The path to the view file.

/**

* Create a new view instance.

*

* @param  \Illuminate\View\Factory  $factory

* @param  \Illuminate\View\Engines\EngineInterface  $engine

* @param  string  $view

* @param  string  $path

* @param  array   $data

* @return void

*/

public function __construct(Factory $factory, EngineInterface $engine, $view, $path, $data = [])

{// create a new instance about this

$this->view = $view;

$this->path = $path;

$this->engine = $engine;

$this->factory = $factory;

$this->data = $data instanceof Arrayable ? $data->toArray() : (array) $data;

}// something about the view

/**

* Get the string contents of the view.

*

* @param  callable|null  $callback

* @return string

*/

public function render(callable $callback = null)

{//Get the string contents of the view.

try {

$contents = $this->renderContents();// get the contents

$response = isset($callback) ? call_user_func($callback, $this, $contents) : null;

// get response

// Once we have the contents of the view, we will flush the sections if we are

// done rendering all views so that there is nothing left hanging over when

// another view gets rendered in the future by the application developer.

$this->factory->flushSectionsIfDoneRendering();// flush Sections

return ! is_null($response) ? $response : $contents;// is_null

} catch (Exception $e) {

$this->factory->flushSections();

throw $e;//Exception

} catch (Throwable $e) {

$this->factory->flushSections();

throw $e;

}

}

/**

* Get the contents of the view instance.

*

* @return string

*/

protected function renderContents()

{// render contents

// We will keep track of the amount of views being rendered so we can flush

// the section after the complete rendering operation is done. This will

// clear out the sections for any separate views that may be rendered.

$this->factory->incrementRender();// inc render

$this->factory->callComposer($this);// call composer

$contents = $this->getContents();// getContents

// Once we've finished rendering the view, we'll decrement the render count

// so that each sections get flushed out next time a view is created and

// no old sections are staying around in the memory of an environment.

$this->factory->decrementRender();// decrement Render

return $contents;

}

/**

* Get the sections of the rendered view.

*

* @return array

*/

public function renderSections()

{

return $this->render(function () {

return $this->factory->getSections();

});

}//render Sections

/**

* Get the evaluated contents of the view.

*

* @return string

*/

protected function getContents()

{

return $this->engine->get($this->path, $this->gatherData());

}// get contents

/**

* Get the data bound to the view instance.

*

* @return array

*/

protected function gatherData()

{//Get the data bound to the view instance

$data = array_merge($this->factory->getShared(), $this->data);

foreach ($data as $key => $value) {

if ($value instanceof Renderable) {

$data[$key] = $value->render();

}

}

return $data;

}//gather the shared and this data

/**

* Add a piece of data to the view.

*

* @param  string|array  $key

* @param  mixed   $value

* @return $this

*/

public function with($key, $value = null)

{// add a piece of data to the view

if (is_array($key)) {// is array

$this->data = array_merge($this->data, $key);

} else {

$this->data[$key] = $value;

}

return $this;

}// return this

/**

* Add a view instance to the view data.

*

* @param  string  $key

* @param  string  $view

* @param  array   $data

* @return $this

*/

public function nest($key, $view, array $data = [])

{

return $this->with($key, $this->factory->make($view, $data));

}//Add a view instance to the view data

/**

* Add validation errors to the view.

*

* @param  \Illuminate\Contracts\Support\MessageProvider|array  $provider

* @return $this

*/

public function withErrors($provider)

{

if ($provider instanceof MessageProvider) {

$this->with('errors', $provider->getMessageBag());

} else {

$this->with('errors', new MessageBag((array) $provider));

}// set errors

return $this;

}//Add validation errors to the view

/**

* Get the view factory instance.

*

* @return \Illuminate\View\Factory

*/

public function getFactory()

{

return $this->factory;

}//big get

/**

* Get the view's rendering engine.

*

* @return \Illuminate\View\Engines\EngineInterface

*/

public function getEngine()

{

return $this->engine;

}//get

/**

* Get the name of the view.

*

* @return string

*/

public function name()

{

return $this->getName();

}//get

/**

* Get the name of the view.

*

* @return string

*/

public function getName()

{

return $this->view;

}//get

/**

* Get the array of view data.

*

* @return array

*/

public function getData()

{

return $this->data;

}//get

/**

* Get the path to the view file.

*

* @return string

*/

public function getPath()

{

return $this->path;

}//get

/**

* Set the path to the view.

*

* @param  string  $path

* @return void

*/

public function setPath($path)

{

$this->path = $path;

}//set

/**

* Determine if a piece of data is bound.

*

* @param  string  $key

* @return bool

*/

public function offsetExists($key)

{

return array_key_exists($key, $this->data);

}//set

/**

* Get a piece of bound data to the view.

*

* @param  string  $key

* @return mixed

*/

public function offsetGet($key)

{

return $this->data[$key];

}//set

/**

* Set a piece of data on the view.

*

* @param  string  $key

* @param  mixed   $value

* @return void

*/

public function offsetSet($key, $value)

{

$this->with($key, $value);

}//set

/**

* Unset a piece of data from the view.

*

* @param  string  $key

* @return void

*/

public function offsetUnset($key)

{

unset($this->data[$key]);

}//set

/**

* Get a piece of data from the view.

*

* @param  string  $key

* @return mixed

*/

public function &__get($key)

{

return $this->data[$key];

}// very good get type

/**

* Set a piece of data on the view.

*

* @param  string  $key

* @param  mixed   $value

* @return void

*/

public function __set($key, $value)

{

$this->with($key, $value);

}

/**

* Check if a piece of data is bound to the view.

*

* @param  string  $key

* @return bool

*/

public function __isset($key)

{

return isset($this->data[$key]);

}

/**

* Remove a piece of bound data from the view.

*

* @param  string  $key

* @return bool

*/

public function __unset($key)

{

unset($this->data[$key]);

}

/**

* Dynamically bind parameters to the view.

*

* @param  string  $method

* @param  array   $parameters

* @return \Illuminate\View\View

*

* @throws \BadMethodCallException

*/

public function __call($method, $parameters)

{

if (Str::startsWith($method, 'with')) {

return $this->with(Str::snake(substr($method, 4)), $parameters[0]);

}

throw new BadMethodCallException("Method [$method] does not exist on view.");

}//Dynamically bind parameters to the view.

/**

* Get the string contents of the view.

*

* @return string

*/

public function __toString()

{

return $this->render();

}// to String

}