หน้าแรก>ซอร์สโค้ด JSP>หมวดหมู่อื่นๆ
ดาวน์โหลด

สำคัญ

สวัสดีทุกคน! นี่คือ Viktor ที่ทำงานส่วนขยาย phpstan นี้ ฉันวางแผนที่จะหยุดการมีส่วนร่วมในระบบนิเวศของ WordPress เพราะมันยากมากและไม่มีใครขอให้ฉัน เข้าร่วมทีมของเขา เพราะฉันเป็นนักคิดคน Devops ผู้ผลิตเครื่องมือ (ไม่ใช่ผู้สร้าง)

โปรดสนับสนุนงานของฉันเพื่อหลีกเลี่ยงการละทิ้งแพ็คเกจนี้

ขอบคุณ!

ส่วนขยาย WordPress สำหรับ phpstan

การวิเคราะห์แบบคงที่สำหรับระบบนิเวศของ WordPress

  • phpstan
  • Wordpress

คุณสมบัติ

  • ช่วยให้ PHPSTAN วิเคราะห์ปลั๊กอินและธีม WordPress
  • โหลดแพ็คเกจ php-stubs/wordpress-stubs
  • ให้ส่วนขยายประเภทการส่งคืนแบบไดนามิกสำหรับฟังก์ชั่นที่ไม่ครอบคลุมใน php-stubs/wordpress-stubs
  • กำหนดค่าคงที่หลักของ WordPress
  • ตรวจสอบ docblocks เสริมก่อนที่ apply_filters() และ do_action() การโทรรักษาประเภทของ @param แรกอย่างชัดเจน

ความต้องการ

  • phpstan 2.0 หรือสูงกว่า
  • PHP 7.4 หรือสูงกว่า (ทดสอบถึง PHP 8.3)

การติดตั้ง

ในการใช้ส่วนขยายนี้ต้องใช้ในนักแต่งเพลง: 

composer require --dev szepeviktor/phpstan-wordpress

หากคุณติดตั้ง PHPSTAN/EXTENSION-INSTALLER คุณก็พร้อมแล้ว!

การติดตั้งด้วยตนเอง

หากคุณไม่ต้องการใช้ phpstan/extension-installer ให้รวมส่วน extension.neon ในการกำหนดค่า phpstan ของโครงการของคุณ: 

 includes :
    - vendor/szepeviktor/phpstan-wordpress/extension.neon

การกำหนดค่า

ไม่จำเป็นต้องมีการตั้งค่าเพิ่มเติม - เพียงกำหนดค่า phpstan - ตัวอย่าง - ดังที่แสดงด้านล่าง: 

 parameters :
    level : 5
    paths :
        - plugin.php
        - inc/

สำหรับรายละเอียดเพิ่มเติมโปรดเยี่ยมชมการอ้างอิงการกำหนดค่า phpstan

ใช้นักแต่งเพลง AutoLoader หรือ AutoLoader ที่กำหนดเอง!

การใช้งาน

เรียกใช้การวิเคราะห์ด้วย: 

vendor/bin/phpstan analyze

จากนั้นแก้ไขข้อผิดพลาดและ GOTO 10 !

คุณพบข้อมูลเพิ่มเติมในไดเรกทอรี examples เช่น examples/phpstan.neon.dist

การใช้งานใน woocommerce webshops

อ้างถึงต้นขั้ว WooCommerce สำหรับคำแนะนำเฉพาะ

การใช้ docblock apply_filters()

ระบบนิเวศของ WordPress มักจะใช้ docblocks phpDoc ในวิธีที่ไม่ได้มาตรฐานในการจัดทำเอกสารพารามิเตอร์ที่ส่งผ่านไปยัง apply_filters() นี่คือตัวอย่าง: 

 /**
 * Filters the page title when creating an HTML drop-down list of pages.
 *
 * @param string  $title Page title.
 * @param WP_Post $page  Page data object.
 */
$ title = apply_filters ( ' list_pages ' , $ title , $ page );

ส่วนขยายนี้อ่าน docblock เหล่านี้และสั่งให้ PHPStan ปฏิบัติต่อประเภทการส่งคืนของตัวกรองอย่างแน่นอนตามแท็ก @param แรก ในตัวอย่างนี้ phpstan ตีความ $title เป็น string

เพื่อผลลัพธ์ที่ดีที่สุดตรวจสอบให้แน่ใจว่าแท็ก @param แรกใน docblock เหล่านี้มีความถูกต้อง

ทำให้รหัสของคุณทดสอบได้

  • เขียน Clean OOP Code: 1 คลาสต่อไฟล์และไม่มีรหัสเพิ่มเติมนอก class Name { ... }
  • ใช้การตั้งชื่อคลาสที่สอดคล้องกัน (WPCS หรือ PSR-4) และคลาสการจัดเก็บในไดเรกทอรี inc/ DIRECTORY โดยเฉพาะ
  • เพิ่มบล็อก PHPDOC ที่แม่นยำลงในคลาสคุณสมบัติวิธีการฟังก์ชันและการเรียก apply_filters()
  • เลือกชิ้นส่วนไฟล์ปลั๊กอินหลักของคุณ
  • หลีกเลี่ยงการใช้ค่าคงที่หลักใช้ฟังก์ชั่นหลัก
  • หลีกเลี่ยงการปฏิบัติ PHP ที่ไม่ดีเช่น:
    • ฟังก์ชั่น: eval , extract , compact , list
    • พิมพ์การเล่นปาหี่: $a = '15'; if ($a) ...
  • หากคุณต้องการรหัสที่แข็งแกร่งให้ลองหลีกเลี่ยงการเล่นปาหี่ทุกชนิด (เช่น if ต้องการบูลีน) ให้ดูฟังก์ชั่นการจัดการตัวแปร
  • หลีกเลี่ยงการเปิดใช้ exit_error ใน WP_CLI::launch หรือ WP_CLI::runcommand เพื่อการทดสอบที่ดีขึ้น

Dirty Corner (คำถามที่พบบ่อย)

WordPress ใช้ฟังก์ชั่นเงื่อนไขและคำจำกัดความของคลาสเพื่ออนุญาตให้แทนที่ ใช้คำสั่ง sed เพื่อแยกสตับฟังก์ชั่นเมื่อกำหนดไว้ก่อนหน้านี้ 

sed -i -e ' s#function is_gd_image#function __is_gd_image# ' vendor/php-stubs/wordpress-stubs/wordpress-stubs.php
ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด