Drupal 8 모듈 구축 : 라우팅, 컨트롤러 및 메뉴 링크-PHP 튜토리얼-php.cn

집

백엔드 개발

PHP 튜토리얼

Drupal 8 모듈 구축 : 라우팅, 컨트롤러 및 메뉴 링크

尊渡假赌尊渡假赌尊渡假赌

Feb 21, 2025 am 09:45 AM

Build a Drupal 8 Module: Routing, Controllers and Menu Links

코어 포인트

Drupal 8은 절차 적 프로그래밍에서 객체 지향 아키텍처로 이동하고 Symfony 구성 요소와 같은 중요한 추가 기능을 포함하여 자랑스럽게 찾은 다른 곳의 프로그램을 통해 다른 소스의 코드를 통합합니다.

drupal 8 모듈 생성을 위해서는 파일과 같은 필요한 폴더 구조 및 파일을 정의해야합니다. 사용자 정의 및 기여 모듈 폴더는 이제 루트 디렉토리 바로 아래에 있으며 핵심 코드는 별도의

폴더로 이동됩니다.

Drupal 8의 "라우팅"은 Drupal 7의

함수를 대체하여 Symfony2 구성 요소를 활용합니다. 여기에는 경로를 구성으로 정의하고 컨트롤러에서 콜백 함수를 처리하는 것이 포함됩니다. 모듈의 라우팅 파일 .info.yml는 모듈 루트 폴더에서 생성됩니다. modules/ 메뉴 링크는 더 이상 core/를 통해 처리되지 않지만 YML 파일의 구성으로 선언됩니다. 모듈 루트 디렉토리에서 라는 파일을 만들어 사이트의 기존 메뉴에서 메뉴 링크와 해당 위치를 정의하십시오.

hook_menu() 작성 당시 Drupal 8이 여전히 개발 중이므로 일부 코드는 구식 일 수 있습니다. 샘플 코드를 업데이트하려고 시도한 코드 기반을 참조하여 최신 Drupal 8 버전과 호환됩니다. demo.routing.yml Drupal 8은 다른 최신 PHP 프레임 워크와 일치하기 위해 많은 변경 사항을 소개합니다. 이는 이전 PHP 4 스타일의 절차 프로그래밍이 객체 지향 아키텍처로 크게 대체되었음을 의미합니다. 이를 달성하기 위해 자랑스럽게 발견 된 다른 곳의 프로그램에서 Drupal 8에는 Drupal을 위해 특별히 개발되지 않은 코드가 포함되어 있습니다.

Drupal에 가장 중요한 추가 사항 중 하나는 Symfony 구성 요소이며 Drupal 개발자에게 두 가지 큰 영향을 미칩니다. 첫째, Drupal을 위해 개발하고자하는 개발자의 수를 크게 늘릴 가능성이 있습니다. 둘째, 현대적인 PHP 실습 경험이 부족한 일부 Drupal 7 개발자에게는 약간의 우려가 남았습니다. 그러나 우리는 모두 배우고, 우리가 Symfony와 같은 프레임 워크 (그리고 희망적으로 Drupal 8)에서 배운 경험은 다른 PHP 프레임 워크에 쉽게 확장되고 적용될 것입니다.

한편, Drupal 8은 릴리스주기의 후기 단계에 있으며 Alpha11을 작성할 때 현재 버전입니다. 우리는이 버전을 사용하여 Drupal 7 개발자가 먼저 만나고 익숙 해야하는 모듈 개발의 몇 가지 기본 변경을 보여줄 것입니다. 이 시리즈에서 쓴 코드를 찾을 수있는 git 코드베이스를 설정했으며, 원하는 경우 다음과 같이 배울 수 있습니다. hook_menu() 모듈을 만드는 방법?

우리가 초점을 맞춰야 할 첫 번째는 Drupal 8이 새로운 모듈을 이해할 수 있도록 필요한 폴더 구조 및 파일을 정의하는 것입니다. Drupal 7에서는 적어도 두 개의 파일 ( 및

)을 만들어야하지만 Drupal 8에서는 전자의 Yaml 버전으로 충분합니다. 예, 파일은 이제 유사한 데이터를 포함하지만 구조가 다른

파일로 대체됩니다. .info 또 다른 큰 변화는 사용자 정의 및 기여 모듈 폴더가 이제 루트 디렉토리 .module 폴더로 직접 이동한다는 것입니다. 이는 모든 핵심 코드가 자체 별도의 .info 폴더로 이동 되었기 때문입니다. 물론 디렉토리에서는 모듈을 custom .info.yml 및

기여 로 분리하는 것이 좋습니다. modules/ Demo (매우 독창적)라는 모듈을 만들어 디렉토리에 넣으십시오. 앞서 언급했듯이 새로 생성 된이 core/ 폴더 내에서 먼저 다음 필요한 내용을 포함하는 modules/ 파일 만 필요합니다. 4 개의 키 값 쌍 중 3 개 (이름, 설명 및 코어)에 익숙해야합니다. 테마에 대한 YML 파일을 만들 수 있으므로 이제 유형도 요구 사항입니다. 주목해야 할 또 다른 중요한 사항은 YML 파일의 공간이 의미가 있고 올바른 압입을 사용하여 데이터를 배열과 같은 구조로 구성한다는 것입니다. 모듈 파일에 추가 할 수있는 추가 키 값 쌍 의이 문서 페이지 와이 형식의 변경 사항을 알리는 지침에 대해서는이 문서 페이지를 볼 수 있습니다. 파일과 같다. 이제 확장 페이지로 이동하여 데모 모듈을 찾아 활성화 할 수 있습니다. 내가 언급했듯이 모듈을 활성화하기 전에 더 이상 파일을 만들 필요가 없습니다. 건축 적으로 말하면, 대부분의 비즈니스 논리가 서비스 클래스, 컨트롤러 및 플러그인으로 이동되므로 파일의 크기가 크게 줄어들지 만 나중에 일부를 볼 수 있습니다. "라우팅"이란 무엇이며 콜백 함수는 어떻게됩니까?

Drupal 7에서 modules/custom/는 아마도 Drupal의 경로를 정의하고 이러한 경로를 콜백 함수에 연결하는 데 사용되기 때문에 아마도 가장 구현 된 후크 일 것입니다. 또한 메뉴 링크 및 기타 여러 컨텐츠를 작성해야합니다. demo/ Drupal 8에서는 더 이상 Symfony2 구성 요소를 사용하여 라우팅을 처리 할 필요가 없습니다. 여기에는 경로를 구성으로 정의하고 컨트롤러 (컨트롤러 클래스의 함수)에서 콜백 함수를 처리하는 것이 포함됩니다. Classic Hello World를 출력하는 간단한 페이지를 만들어이 작업을 수행하십시오. demo.info.yml 먼저 모듈에

라는 라우팅 파일을 만들어야합니다. 이 파일은 모듈 루트 폴더 ()에 있습니다. 이 파일에서는 다음 (간단한) 경로 정의를 가질 수 있습니다.

name: Drupal 8 Demo module
description: 'Demo module for Drupal 8 alpha11'
type: module
core: 8.x

첫 번째 줄은 모듈 데모에 대한 데모라는 새 경로를 만드는 시작을 나타냅니다 (첫 번째는 모듈 이름이고 두 번째는 경로 이름입니다). 경로 에서이 경로에 등록하는 경로를 지정합니다. 기본값 아래에는 기본 페이지 제목 ()과 의 두 가지가 있습니다. 요구 사항에 따라 페이지를보기 위해 사용자가 가야 할 권한을 지정합니다. 이 라우팅 파일에 더 많은 옵션을 보려면이 문서 페이지를 참조해야합니다.

이제 사용자 가이 페이지를 요청할 때 Demo ()라는 함수를 호출하는 DemoconTroller라는 첫 번째 컨트롤러를 작성하겠습니다. _title 모듈 디렉토리에서 SRC/라는 폴더를 작성하고 컨트롤러/ in이라는 폴더를 만듭니다. 이것은 컨트롤러 클래스가 저장되는 곳입니다. 첫 번째를 계속 만듭니다 : democontroller.php. _content 컨트롤러와 다른 클래스는 나중에 SRC/ 폴더로 볼 수 있습니다. PSR-4 표준의 일부입니다. 처음에는 더 큰 폴더 구조 (PSR-0 표준)를 만들어야했지만 이제는 두 가지가 작동하는 전환 단계가 있습니다. 따라서 여전히 lib/라는 폴더에 배치 된 코드가 표시되면 PSR-0입니다.

democontroller.php 파일에서 이제 클래스를 선언 할 수 있습니다.

이것은 페이지에 무언가를 표시하기 위해 가장 쉽고 가장 적은 양입니다. 맨 위에는 클래스 네임 스페이스를 지정합니다. 아래는 클래스를 선언합니다.

DemoController 클래스에는 Demo () 함수 만 있으며 Drupal 7과 유사한 렌더링 가능한 배열을 반환합니다. 큰 문제가 아닙니다. 우리가 지금해야 할 일은 캐시를 지우고

https://www.php.cn/link/1a4a5f89e71e4bb997335c964a950b4

로 이동하는 것입니다.

메뉴 링크는 어디에 있습니까? Drupal 7에서 를 구현할 때 메뉴에 등록 된 경로를 추가하여 사이트에 메뉴 링크를 표시 할 수도 있습니다. 다시 말하지만, 이것은 더 이상이 후크로 처리되지 않고 대신 YML 파일을 사용한 구성으로 메뉴 링크를 정의합니다.

관리 된 "구조"메뉴 아래에 나타나는 메뉴 링크를 만드는 방법을 살펴 보겠습니다. 먼저 모듈의 루트 디렉토리에

라는 파일을 만들어야합니다. 이 YML 파일에서는 사이트의 기존 메뉴에서 메뉴 링크와 위치를 정의합니다. 우리가 설정 한 목표를 달성하려면 다음이 필요합니다.

demo.demo:
  path: '/demo'
  defaults:
    _content: '\Drupal\demo\Controller\DemoController::demo'
    _title: 'Demo'
  requirements:
    _permission: 'access content'

우리는 다시 한 번 계약 기반 YML 구조를 가지고 있으며, 여기서 모듈 데모의 메뉴 링크의 기계 이름 (데모)을 먼저 정의합니다 (라우팅과 같이). 다음으로 링크 제목과 설명이 있으며이 링크의 부모 (위치)와 사용 해야하는 경로가 있습니다.

부모의 값은 부모 메뉴 링크 (모듈 첨부)이며, 찾으려면 *.menu_links.yml 파일을 파는 것이 필요합니다. "구조"링크는 핵심 시스템 모듈에 정의되어 있으므로 System.menu_links.yml 파일을 보면이 링크의 이름을 결정할 수 있습니다.

Route_Name 은이 링크에 사용하려는 경로의 기계의 이름입니다. 우리는 전에 우리를 정의했습니다. 이를 사용하면 캐시를 지우고 https://www.php.cn/link/6c2665d7c3ed1e5bfd8ba600f026eb55

Demo/Path로 이동할 수 있습니다. 좋은.

결론 이 기사에서는 Drupal 8의 모듈 개발을 탐색하기 시작합니다. 이 단계 (Alpha11 버전)에서는 새로운 API 및 포트 기여 모듈을 사용하는 방법을 배우기 시작할 때입니다. 이를 위해, 나는이 새로운 흥미 진진한 프레임 워크 (Drupal 8)에 대한 탐구를 작성하여 이러한 변경 사항에 대해 배우고 출시일이 오면 즉시 작업에 참여할 수 있습니다.

먼저, 우리는 몇 가지 기본 사항을 배웠습니다 : Drupal 8 모듈 (파일, 폴더 구조 등)을 시작하고 Drupal 7과 비교하는 방법. 또한 경로와 컨트롤러 클래스를 정의하는 방법 과이 경로를 통해 함수를 호출하는 방법을 배웠습니다. 마지막으로, 우리는 정의한 경로를 사용하는 메뉴 링크를 만드는 방법을 볼 수 있습니다.

다음 자습서에서는이 모듈을 계속 구축하고 Drupal 8이 사용하는 다른 멋진 새로운 기능에 대해 계속 배울 것입니다. 블록을 만드는 방법과 양식을 사용하고 시스템을 구성하는 방법을 배웁니다. 그럼 보자.

Drupal 8 모듈 (FAQ) FAQ Drupal 8 모듈의 기본 구조는 무엇입니까?

Drupal 8 모듈은 본질적으로 특정 기능을 포함하는 파일 세트이며 특정 방식으로 내장됩니다. 기본 구조에는 파일 (모듈에 대한 메타 데이터 제공), 파일 (php 코드 포함) 및 , , 등과 같은 기타 옵션 파일 등이 포함됩니다. 부착 기능. 파일은 필수이며, 모듈의 이름, 설명, 패키지, 유형, 코어 및 종속성을 정의합니다. Drupal 8의 라우팅 시스템은 어떻게 작동합니까? Drupal 8의 라우팅 시스템은 URL을 특정 컨트롤러 클래스에 매핑 할 책임이 있습니다. Symfony의 라우팅 구성 요소를 사용하여 유연하고 강력한 시스템이 가능합니다. 라우팅 시스템은

파일을 사용하여 고유 한 이름, 경로, 기본값 및 요구 사항이있는 경로를 정의합니다. 기본값은 일반적으로 요청 처리를 담당하는 컨트롤러 클래스를 지정합니다.

Drupal 8에서 사용자 정의 페이지를 만드는 방법은 무엇입니까?

Drupal 8에서 사용자 정의 페이지를 작성하려면 경로와 컨트롤러를 정의해야합니다. 경로는

파일에 정의되어 URL을 컨트롤러에 맵핑합니다. 컨트롤러는 페이지 컨텐츠에 대한 렌더링 된 배열을 반환하는 PHP 클래스입니다. 컨트롤러 클래스는 모듈의

디렉토리에 배치해야합니다.