Joomla에서 타사 PHP 라이브러리 연결

PHP 라이브러리는 플러그인, 구성 요소 모델, 모듈 등 애플리케이션의 어느 곳에서나 액세스할 수 있기 때문에 편리합니다. 누군가 이미 유사한 문제를 해결하고 라이브러리로 설계한 경우(심지어 업데이트까지), 이 라이브러리를 Joomla에 연결하는 것이 좋습니다. 예를 들어 온라인 상점에 대한 결제 방법을 개발하려면 결제 수집기의 공식 라이브러리가 필요합니다. 아니면 일부 CRM의 공식 PHP SDK에 만족하시나요?

작곡가

Joomla는 Composer로 직접 작업하는 것을 지원하지 않습니다. 작업에서 라이브러리를 사용하려면 Joomla 확장 유형 라이브러리에 "래핑"하고 설치해야 합니다. 심각한 프로젝트에서는 프로젝트의 모든 구성 요소 버전을 수정하는 접근 방식이 채택됩니다. 코드는 두 번 이상 확인되고 테스트되었으며 프로덕션에서 작동하도록 허용되었습니다.

라이브러리로 패키지를 만들고 필요할 때마다 설치하세요. 새 버전의 라이브러리가 출시되면 래퍼를 업데이트하고 Joomla 확장 작업의 모든 이점을 얻을 수 있습니다. 즉, CLI를 포함하여 표준 방식으로 확장을 업데이트합니다. 업데이트 등을 하기 전에 관리 영역에서 확장 프로그램의 변경 로그를 확인하세요.

Joomla 5로 업데이트하기 전에 관리 영역에서 변경 로그 확장을 확인하세요.

줌라, PSR, 심포니

Joomla는 PSR 표준을 준수하므로 이러한 점에서 작업하는 것이 편리합니다. 일부 Symfony 패키지는 Joomla 코어(콘솔, 문자열, vardumper, yaml, 오류 처리기 등)에 포함되어 있으므로 갑자기 더 추가하려는 경우 적합하고 잘 작동합니다. 라이브러리/공급업체의 Symfony 구성 요소 외에 Joomla의 다른 가치를 확인할 수 있습니다.

Joomla 확장 프로그램에서 타사 PHP 라이브러리를 래핑하는 방법은 무엇입니까?

복잡한 것은 없습니다. 라이브러리 파일은 일반적으로 src 폴더에 있습니다. 이 폴더 옆에 설명서(manual.joomla.org)에 따라 Joomla 확장의 XML 매니페스트를 생성해야 합니다. 그런 다음 모든 것을 zip 아카이브에 압축하면 그게 전부입니다! 설치 가능합니다.

라이브러리가 작동하기 위해 데이터베이스에 자체 테이블이 필요한 경우 설치 또는 업데이트 중에 SQL 쿼리를 사용하여 필요한 파일을 추가해야 합니다. Joomla 4는 네임스페이스와 함께 작동하므로 확장의 XML 매니페스트에 이 네임스페이스를 지정하는 것이 중요합니다. 다음은 Joomla 라이브러리용 XML 매니페스트의 축약된 예입니다.

<?xml version="1.0" encoding="UTF-8" ?>
<extension type="library" method="upgrade">
     <name>WebTolk AmoCRM library</name>
     <libraryname>Webtolk/Amocrm</libraryname>
     <version>1.2.1</version>
     ...
     <namespace path="src">Webtolk\Amocrm</namespace>
     <files>
          <folder>src</folder>
          <filename>amocrm.xml</filename>
     </files>
</extension>

<도서관 이름> 태그는 아카이브의 src 폴더가 JPATH_SITE/libraries/Webtolk/Amocrm에 복사된다는 것을 의미합니다. <파일> 섹션에는 아카이브에서 채워야 할 내용이 표시됩니다. 그리고 WebtolkAmocrm JPATH_SITE/libraries/Webtolk/Amocrm의 src 폴더에 WebtolkAmocrm 네임스페이스를 등록해야 한다고 나와 있습니다.

중요 사항!

• Joomla 4.2.7 이전에는 실제로 XML 매니페스트에서 작동하지 않았습니다. 따라서 JLoader 클래스를 사용하여 onAfterInitialize 이벤트(Event Dispatcher)에 네임스페이스를 등록할 라이브러리 패키지에 시스템 플러그인을 추가해야 했습니다. 따라서 라이브러리와 플러그인에서 패키지를 빌드해야 했습니다. Joomla 4.2.7부터 수정되어 플러그인 없이도 가능합니다.
• 지금까지는 라이브러리 업데이트 = 재설치. 즉, 확장 프로그램이 제거되고 설치됩니다. 이 결정은 Joomla 3.x 버전의 깊은 부분에서 이루어졌습니다. 왜? -PR 산 아래 숨겨져 있습니다. 검색이 필요합니다. 이것이 왜 중요합니까? 확장 기능을 설치할 때 확장 기능의 "레지스트리"(#__extensions 테이블의 데이터베이스)에 항목이 생성되기 때문입니다. 이 테이블에는 TEXT 유형(params 및 custom_data)의 2개 열이 있습니다. 그리고 이것은 상당한 양의 데이터라는 것을 인정해야 합니다. JoomlaCMSHelperLibraryHelper를 사용하여 데이터베이스에 일부 라이브러리 매개변수를 저장하는 경우 설치 프로그램의 이 동작을 고려하고 사전 저장한 다음 라이브러리를 업데이트할 때 저장된 매개변수를 확장 프로그램의 설치 프로그램 스크립트에 다시 추가해야 합니다.

<?php
use Joomla\CMS\Helper\LibraryHelper;
use Joomla\CMS\Cache\Cache;

/**
 * Function called before extension installation/update/removal procedure commences.
 *
 * @param   string            $type     The type of change (install or discover_install, update, uninstall)
 * @param   InstallerAdapter  $adapter  The adapter calling this method
 *
 * @return  boolean  True on success
 *
 * @since   1.0.0
 */
public function preflight(string $type, InstallerAdapter $adapter): bool
{
    if ($type == 'uninstall')
    {
        return true;
    }

    /**
     *
     *  Joomla when updating extensions of the library type, it actually deletes them (along with the data in the database),
     *  and then installs it again.
     *  In order to avoid losing library data from the database, we are writing this crutch.
     *
     * @see https://github.com/joomla/joomla-cms/issues/39360
     *
     */

    if ($type == 'update')
    {
        $lib_params = LibraryHelper::getParams('Webtolk/Amocrm');
        $jconfig    = $this->app->getConfig();
        $options    = array(
            'defaultgroup' => 'wt_amo_crm_temp',
            'caching'      => true,
            'cachebase'    => $jconfig->get('cache_path'),
            'storage'      => $jconfig->get('cache_handler'),
        );
        $cache      = Cache::getInstance('', $options);
        $cache->store($lib_params, 'wt_amo_crm_temp');

    }

    return true;

}

그리고 그에 따라 postflight() 메소드에서 LibraryHelper::saveParams('Webtolk/Amocrm', $lib_params);를 사용하여 저장된 매개변수를 다시 넣습니다.

• 라이브러리가 작동하려면 확장 관리자에서 활성화해야 합니다(메뉴 - 시스템 - 관리 - 확장).
• 종종 라이브러리가 작동하려면 특정 매개변수(API 키, 토큰 등)가 필요하며, 이는 Joomla 관리 영역의 사람들이 지정해야 합니다. 이러한 목적을 위해 플러그인을 작성하는 것이 편리합니다. (확장 유형 라이브러리에는 매개변수 구성을 위한 자체 인터페이스가 없습니다). 시스템 그룹이나 사용자 정의 그룹은 중요하지 않습니다. 라이브러리 내에서 다음과 같이 플러그인 매개변수를 매우 빠르게 얻을 수 있습니다.

<?php
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\Registry\Registry;

if (PluginHelper::isEnabled('system', 'wt_amocrm'))
   {
      $plugin        = PluginHelper::getPlugin('system', 'wt_amocrm');
      $params        = \json_decode($plugin->params);
      $param = $params->param;
      // OR you can use Joomla\Registry\Registry
      $params = new Registry($plugin->params);
      $param = $params->get('param', 'defatul value if empty');
   }

Joomla 커뮤니티 리소스

• https://joomla.org/
• Mattermost의 Joomla 커뮤니티 채팅
• WebTolk Joomla 확장
• 러시아어로 작성된 이 기사

위 내용은 Joomla에서 타사 PHP 라이브러리 연결의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!