PHP Yii Framework_php 기술의 프런트엔드 리소스 패키지 사용에 대한 자세한 설명-PHP 튜토리얼-php.cn

Yii의 리소스는 웹 페이지와 관련된 파일로 CSS 파일, JavaScript 파일, 이미지 또는 비디오 등이 될 수 있습니다. 리소스는 웹에 액세스할 수 있는 디렉터리에 배치되며 웹 서버에서 직접 호출됩니다.

예를 들어, 페이지에서 yiijuiDatePicker 위젯을 사용하면 필요한 CSS 및 JavaScript 파일을 수동으로 찾아서 포함시키는 대신 자동으로 리소스를 관리하는 것이 좋습니다. 위젯을 업그레이드하면 자동으로 새 버전의 리소스 파일이 사용됩니다. 이 튜토리얼에서는 Yii가 제공하는 강력한 리소스 관리 기능을 자세히 설명합니다.

리소스팩

Yii는 리소스 패키지에서 리소스를 관리합니다. 리소스 패키지는 단순히 디렉터리에 있는 리소스 모음입니다. 리소스 패키지가 뷰에 등록되면 웹 페이지를 렌더링할 때 패키지의 CSS 및 JavaScript 파일이 포함됩니다.

리소스 패키지 정의

리소스 패키지는 yiiwebAssetBundle을 상속하는 PHP 클래스로 지정됩니다. 패키지 이름은 자동으로 로드할 수 있는 PHP 클래스 이름이며, 리소스 패키지 클래스에는 CSS 및 JavaScript가 포함된 리소스의 위치를 지정해야 합니다. 포함된 파일 및 다른 패키지와의 종속성.

다음 코드는 기본 애플리케이션 템플릿에서 사용되는 기본 리소스 패키지를 정의합니다.

<&#63;php

namespace app\assets;

use yii\web\AssetBundle;

class AppAsset extends AssetBundle
{
 public $basePath = '@webroot';
 public $baseUrl = '@web';
 public $css = [
  'css/site.css',
 ];
 public $js = [
 ];
 public $depends = [
  'yii\web\YiiAsset',
  'yii\bootstrap\BootstrapAsset',
 ];
}

로그인 후 복사

위와 같이 AppAsset 클래스에서 지정한 리소스 파일은 @webroot 디렉터리에 위치하며 해당 URL은 @web입니다. 리소스 패키지에는 JavaScript 파일이 아닌 CSS 파일인 css/site.css가 포함되어 있습니다. 다른 두 패키지 yiiwebYiiAsset 및 yiibootstrapBootstrapAsset 정보 yiiwebAssetBundle의 속성에 대한 자세한 내용은 아래에 설명되어 있습니다.

yiiwebAssetBundle::sourcePath: 리소스 파일이 포함된 번들의 루트 디렉터리를 지정합니다. 웹에서 루트 디렉터리에 액세스할 수 없는 경우 이 속성을 설정해야 합니다. 그렇지 않으면 yiiwebAssetBundle::basePath 속성과 yiiwebAssetBundle::baseUrl을 설정해야 합니다. 세트. 여기에서 경로 별칭을 사용할 수 있습니다.
yiiwebAssetBundle::basePath: 리소스 번들의 리소스 파일을 포함하고 웹에서 액세스할 수 있는 디렉터리를 지정합니다. yiiwebAssetBundle::sourcePath 속성을 지정하면 리소스 관리자가 패키지의 리소스를 웹에서 액세스할 수 있는 디렉터리에 게시합니다. 리소스 파일이 웹에서 액세스할 수 있는 디렉터리에 있는 경우 다시 게시할 필요가 없도록 이 속성을 설정해야 합니다. 여기서 경로 별칭을 사용할 수 있습니다.

yiiwebAssetBundle::baseUrl: yiiwebAssetBundle::basePath 디렉터리에 해당하는 URL을 지정합니다. yiiwebAssetBundle::basePath 속성을 지정하면 리소스 관리자가 이러한 리소스를 게시하고 이 속성을 재정의합니다. 여기서 경로 별칭을 사용할 수 있습니다.
yiiwebAssetBundle::js: 리소스 번들의 JavaScript 파일을 포함하는 배열입니다. 슬래시 "/"를 디렉터리 구분 기호로 사용해야 합니다. 각 JavaScript 파일은 다음 두 가지 형식 중 하나로 지정할 수 있습니다.

리소스 위치

리소스는 위치에 따라 분류될 수 있습니다.

소스 리소스: 리소스 파일과 PHP 소스 코드는 함께 배치되며 웹에서 직접 액세스할 수 없습니다. 이러한 소스 리소스를 사용하려면 웹에서 액세스할 수 있는 웹 디렉터리에 복사하여 게시된 리소스로 만들어야 합니다. 퍼블리싱이라고 합니다. 리소스에 대해서는 나중에 자세히 소개하겠습니다.

리소스 게시: 리소스 파일은 웹을 통해 직접 액세스할 수 있는 웹 디렉터리에 배치됩니다.
외부 리소스: 리소스 파일은 웹 애플리케이션과 다른 웹 서버에 배치됩니다.
리소스 번들 클래스를 정의할 때 yiiwebAssetBundle::sourcePath 속성을 지정하면 상대 경로를 사용하는 모든 리소스가 소스 리소스로 사용된다는 의미입니다. 이 속성을 지정하지 않으면 해당 리소스가 게시된 리소스라는 의미입니다. yiiwebAssetBundle::basePath를 지정하고 yiiwebAssetBundle::baseUrl을 Yii에게 알려야 합니다.

불필요한 리소스 게시 프로세스를 피하기 위해 리소스 파일을 웹 디렉터리에 배치하는 것이 좋습니다. 이것이 바로 이전 예에서 yiiwebAssetBundle::sourcePath 대신 yiiwebAssetBundle::basePath를 지정한 이유입니다.

확장 기능의 경우 해당 리소스와 소스 코드가 웹에서 접근할 수 없는 디렉터리에 있으므로 리소스 번들 클래스를 정의할 때 yiiwebAssetBundle::sourcePath 속성을 지정해야 합니다.

참고: yiiwebAssetBundle::sourcePath 속성에 @webroot/assets를 사용하지 마십시오. 이 경로는 yiiwebAssetManager 리소스 관리자가 소스 리소스를 게시한 후 저장하는 경로로 기본 설정됩니다. 삭제될 수 있습니다.

리소스 종속성

웹 페이지에 여러 CSS 또는 JavaScript 파일이 포함된 경우 속성 덮어쓰기를 방지하기 위한 특정 순서가 있습니다. 예를 들어 웹 페이지에서는 jQuery UI 위젯을 사용하기 전에 jQuery JavaScript 파일이 포함되었는지 확인해야 합니다. 리소스의 순서를 리소스 종속성이라고 합니다.

리소스 종속성은 주로 yiiwebAssetBundle::dependent 속성을 통해 지정됩니다. AppAsset 예에서 리소스 번들은 두 개의 다른 리소스 번들인 yiiwebYiiAsset 및 yiibootstrapBootstrapAsset에 종속됩니다. 파일이 포함된 후에 두 개의 종속성 번들이 포함됩니다.

리소스 종속성은 전이적입니다. 즉, 사람들이 A가 B에 의존하고 B가 C에 의존한다고 말하면 A도 C에 의존합니다.

리소스 옵션

可指定yii\web\AssetBundle::cssOptions 和 yii\web\AssetBundle::jsOptions 属性来自定义页面包含CSS和JavaScript文件的方式，这些属性值会分别传递给 yii\web\View::registerCssFile() 和 yii\web\View::registerJsFile() 方法，在视图调用这些方法包含CSS和JavaScript文件时。

注意: 在资源包类中设置的选项会应用到该包中每个 CSS/JavaScript 文件，如果想对每个文件使用不同的选项，应创建不同的资源包并在每个包中使用一个选项集。
例如，只想IE9或更高的浏览器包含一个CSS文件，可以使用如下选项：

public $cssOptions = ['condition' => 'lte IE9'];

로그인 후 복사

这会是包中的CSS文件使用以下HTML标签包含进来：

<!--[if lte IE9]>
<link rel="stylesheet" href="path/to/foo.css">
<![endif]-->

로그인 후 복사

为链接标签包含