🧔 👩‍👩‍👧‍👧 🙄 PhpBB3 ट्रैप सिस्टम 🤘🏻 🐷 🌷

1. परिचय

यह क्या है

ट्रैप सिस्टम एप्लिकेशन और मॉड डेवलपर्स को phpBB कोड में जाल सेट करने या अपने स्वयं के कार्यों में उपयोग करने की अनुमति देता है।

PhpBB फ़ंक्शन आप के साथ जाल का उपयोग कर सकते हैं

PhpBB में 4 कार्य हैं जिन्हें आप अपने जाल से पकड़ सकते हैं:

phpbb_user_session_handler () - सही तरीके से सत्र और उपयोगकर्ता वस्तुओं को शुरू करने के बाद उपयोगकर्ता :: सेटअप के अंदर;
append_sid ($ url, $ params = false, $ is_amp = true, $ session_id = false) - लिंक बनाने के लिए कहा जाता है (एक सत्र पहचानकर्ता जोड़ें);
$ टेम्प्लेट-> प्रदर्शन ($ संभाल, $ शामिल_सांस = सत्य) - के आउटपुट से ठीक पहले कहा जाता है (अभी तक संकलित नहीं) टेम्पलेट;
exit_handler () - phpBB3 कोड निष्पादन के बहुत अंत में कहा जाता है।

कृपया ध्यान दें: $ टेम्पलेट-> डिस्प्ले का उपयोग करने वाला एक जाल $ टेम्पलेट ($ टेम्पलेट ऑब्जेक्ट का एक संदर्भ) का तीसरा तर्क ले सकता है, जिसका उपयोग वैश्विक के बजाय किया जा सकता है।

यदि आपने अपने एप्लिकेशन के साथ phpBB3 को एकीकृत किया है, तो आप स्थिरांक का उपयोग करना चाह सकते हैं:

PHPBB_MSG_HANDLER (संदेश संचालक को अधिलेखित करें);
PHPBB_DB_NEW_LINK ( sql_connect के लिए new_link पैरामीटर को अधिलेखित करें);
PHPBB_ROOT_PATH ($ phpbb_root_path को अधिलेखित करें);
PHPBB_ADMIN_PATH ($ phpbb_admin_path को अधिलेखित करें);
PHPBB_USE_BOARD_URL_PATH ($ phpbb_root_path के बजाय चित्रों के लिए Gener_board_url का उपयोग करें)।

यदि निरंतर PHPBB_USE_BOARD_URL_PATH सही पर सेट है, तो phpBB सभी अपलोड की गई छवियों के लिए (जो शामिल स्क्रिप्ट पथ के साथ मंच के लिए एक लिंक देता है) उत्पन्न_बोर्ड_url () का उपयोग करता है। यह स्थिरांक फाइलों में है:

/includes/session.php - उपयोगकर्ता :: img ()
/includes/functions_content.php - smiley_text ()

यह टेम्प्लेट चर में पथ भी बदल देगा:
{T_THEME_PATH} - शैलियाँ / xxx / विषय
{T_TEMPLATE_PATH} - शैलियाँ / xxx / टेम्प्लेट
{T_SUPER_TEMPLATE_PATH} - शैलियाँ / xxx / टेम्पलेट
{T_IMAGESET_PATH} - शैलियाँ / xxx / प्रतिमा
{T_IMAGESET_LANG_PATH} - शैलियाँ / xxx / imageset / yy
{T_IMAGES_PATH} - चित्र /
{T_SMILIES_PATH} - $ config ['smilies_path'] /
{T_AVATAR_PATH} - $ config ['अवतार_पथ'] /
{T_AVATAR_GALLERY_PATH} - $ config ['avatar_gallery_path'] /
{T_ICONS_PATH} - $ config ['icons_path'] /
{T_RANKS_PATH} - $ config ['रैंक_पथ'] /]
{T_UPLOAD_PATH} - $ config ['upload_path'] /
{T_STYLESHEET_LINK} - शैलियाँ / xxx / विषय / styleheet.css (या स्टाइल के लिए एक लिंक। अगर सीएसएस गतिशील रूप से उत्पन्न होता है)
नया टेम्प्लेट चर {BOARD_URL} में बोर्ड url + स्क्रिप्ट पथ है।

2. हम वर्ग कार्यों और विधियों में जाल के उपयोग की अनुमति देते हैं

निम्न उदाहरण बताते हैं कि phpBB3 अंतर्निहित जाल प्रणाली का उपयोग कैसे करता है। आपको अपने स्वयं के जाल को पंजीकृत करने में अधिक रुचि हो सकती है, लेकिन इस कोड को प्रदर्शित करने से आपको जाल प्रणाली को बेहतर ढंग से समझने में मदद मिलेगी ...

सबसे पहले, यह उदाहरण दिखाता है कि किसी फ़ंक्शन में आवश्यक कोड को कैसे एम्बेड करना है यदि आप इसे जाल को रोकना चाहते हैं:

function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }
function my_own_function ( $my_first_parameter , $my_second_parameter ) { global $phpbb_hook ; if ( $phpbb_hook -> call_hook ( __FUNCTION__ , $my_first_parameter , $my_second_parameter ) ) { if ( $phpbb_hook -> hook_return ( __FUNCTION__ ) ) { return $phpbb_hook -> hook_return_result ( __FUNCTION__ ) ; } } [ ] }

ऊपर, call_hook फ़ंक्शन को हमेशा आपके फ़ंक्शन के मापदंडों के साथ बुलाया जाना चाहिए।

और यह उदाहरण दिखाता है कि आप एक वर्ग विधि अवरोधन जाल कैसे बना सकते हैं ...

वर्ग my_hookable_object
{
फ़ंक्शन हुक_मे ( $ my_first_parameter , $ my_second_parameter )
{
वैश्विक $ phpbb_hook ;
अगर ( $ phpbb_hook -> call_hook ( सरणी ( __CLASS__ , __FUNCTION__ ) , $ my_first_parameter , $ my_second_parameter )
{
अगर ( $ phpbb_hook -> hook_return ( सरणी ( __CLASS__ , __FUNCTION__ ) ) )
{
$ $ phpbb_hook -> hook_return_result ( सरणी ( __CLASS__ , __FUNCTION__ ) ) ;
}
}
[ यहाँ आपका कोड है ]
}
}

यहां एकमात्र अंतर यह है कि आप पहले पैरामीटर को कैसे परिभाषित करते हैं। फ़ंक्शन के लिए, यह केवल __FUNCTION__ स्थिर है, और विधि के लिए, सरणी सरणी (__ CLASS__, __FUNCTION__)। PHP4 में, __CLASS__ स्थिरांक हमेशा लोअरकेस में वर्ग का नाम देता है।

अब, phpBB में पूर्वनिर्धारित फ़ंक्शंस हैं जो जाल को रोक सकते हैं, लेकिन उन्हें कैसे उपलब्ध करें (और इसलिए दूसरों को उन्हें इंटरसेप्ट करने की अनुमति दें)? इसके लिए एक add_hook () विधि है:

// अपना स्वयं का फ़ंक्शन जोड़ें, जो कर सकते हैं
// जाल को पकड़ना
$ phpbb_hook -> add_hook ( 'my_own_function' ) ;
// अपनी खुद की विधि जोड़ें, जो हो सकता है
// जाल को पकड़ना
$ phpbb_hook -> add_hook ( सरणी ( 'my_hookable_object' , 'hook_me' ) ) ;

आप $ phpbb_hook-> remove_hook () को एक ही पैरामीटर के साथ add_hook () के रूप में कॉल करके फ़ंक्शन / विधि के साथ जाल को बाधित करने की क्षमता को भी हटा सकते हैं। यह उपयोगी है यदि आप चाहते हैं कि कुछ जाल को नहीं बुलाया जाए।

3. ट्रैप लॉगिंग

अब अपने कार्यों को परिभाषित करने के लिए आगे बढ़ते हैं जिन्हें कहा जाएगा। ऐसा करने के लिए, हम एक उदाहरण के रूप में append_sid () फ़ंक्शन लेते हैं (इस फ़ंक्शन का उपयोग डिफ़ॉल्ट जाल द्वारा किया जा सकता है) और दो कक्षाएं और एक फ़ंक्शन बनाएं:

वर्ग my_append_sid_class {
// हमारे कार्य
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false ) {
// पिछले जाल के संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
$ परिणाम लौटाएँ [ 'परिणाम' ] । ' और मैं दूसरा था।' ;
}
}
// एक और वर्ग
वर्ग my_second_append_sid_class {
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false ) {
// पिछले जाल के संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
गूंज $ परिणाम [ 'परिणाम' ] । ' और मैं तीसरा हूं।' ;
}
}
// सामान्य कार्य
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false ) {
// पिछले जाल के संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
वापसी 'मुझे पहले कहा जाता था' ;
}
// द्वितीय श्रेणी का प्रारंभ
$ my_second_append_sid_class = new my_second_append_sid_class ( ) ;

सुनिश्चित करें कि आप अपने फ़ंक्शन में वही पैरामीटर जोड़ते हैं जो एक फ़ंक्शन के लिए परिभाषित होते हैं जो एक अपवाद के साथ जाल को हुक करता है: पहला पैरामीटर हमेशा और $ हुक होता है, हुक ऑब्जेक्ट का संदर्भ जो आप के साथ काम कर सकते हैं।

अब हम $ phpbb_hook-> रजिस्टर () विधि का उपयोग करके एक के बाद एक ट्रैप को पंजीकृत करेंगे:

// अब हम क्रम में append_sid फ़ंक्शन के हमारे "विकल्प" को पंजीकृत करेंगे ...
// रजिस्टर (पहले बुलाया)
$ phpbb_hook -> रजिस्टर ( 'append_sid' , 'my_append_sid' ) ;
// प्रथम श्रेणी पंजीकृत करें
$ phpbb_hook -> रजिस्टर ( 'append_sid' , array ( 'my_append_sid_class' , 'my_append_sid' ) ) ;
// .. और द्वितीय श्रेणी
$ phpbb_hook -> रजिस्टर ( 'append_sid' , array ( & $ my_second_append_sid_class , 'my_append_sid' ) ) ;

इस उदाहरण के साथ, आप अपने स्वयं के कार्यों को स्वयं को रोकने के लिए मजबूर कर सकते हैं:

// उस जाल को पंजीकृत करें जो phpbb द्वारा पकड़ा जाएगा
$ phpbb_hook -> रजिस्टर ( 'append_sid' , 'my_own_append_sid' ) ;
// एक फ़ंक्शन जोड़ें जो जाल को रोक देगा
$ phpbb_hook -> add_hook ( 'my_own_append_sid' ) ;
// एक ट्रैप पंजीकृत करें जो हमारे फ़ंक्शन द्वारा इंटरसेप्ट किया जाएगा
$ phpbb_hook -> रजिस्टर ( 'my_own_append_sid' , 'also_my_own_append_sid' ) ;

विशेष प्रसंस्करण / चेन

हुक पंजीकरण विधि विशेष चाइनिंग मोड को निर्धारित करने के लिए तीसरे तर्क को स्वीकार करने में सक्षम है। यह मान ले सकता है: पहला , अंतिम और स्टैंडअलोन ।

$ phpbb_hook-> रजिस्टर ('append_sid', 'my_own_append_sid', 'first') श्रृंखला की शुरुआत में एक फ़ंक्शन कॉल की गारंटी देता है। पहले ब्लॉक के अंदर एक से अधिक फ़ंक्शन को कॉल किया जा सकता है - FIFO सिद्धांत का उपयोग यहां किया जाता है;
$ phpbb_hook-> रजिस्टर ('append_sid', 'my_own_append_sid', 'last') श्रृंखला के अंत में एक फ़ंक्शन कॉल की गारंटी देता है। उत्तरार्द्ध के भीतर एक से अधिक फ़ंक्शन के कॉल संभव हैं - फीफो सिद्धांत का उपयोग यहां किया जाता है;
$ phpbb_hook-> रजिस्टर ('append_sid', 'my_own_append_sid', 'standalone') यह सुनिश्चित करता है कि केवल एक विशिष्ट फ़ंक्शन कहा जाता है। अन्य सभी कार्यों को श्रृंखला से हटा दिया जाता है और अन्य कार्यों को इसके बाद नहीं जोड़ा जाता है। यदि दो एप्लिकेशन स्टैंडअलोन मोड को स्विच करने का प्रयास करते हैं, तो एक PHP अधिसूचना प्रदर्शित की जाएगी, और दूसरे फ़ंक्शन को अनदेखा किया जाएगा।

वस्तुओं के लिए जाल का संकल्प

क्योंकि जाल प्रणाली आरंभिक वस्तुओं के बीच अंतर नहीं कर सकती है, लेकिन केवल कक्षाओं में ही संचालित होती है, आपको इसे कोड स्तर पर हल करना होगा।

एक संपत्ति का उपयोग करने का एक संभावित तरीका है:

वर्ग my_hookable_object {
फंक्शन ब्लाब्ला ( )
{
}
}
वर्ग my_hookable_object2 my_hookable_object का विस्तार करता है
{
var $ call_hook = true ;
फ़ंक्शन हुक_मे ( $ my_first_parameter , $ my_second_parameter )
{
अगर ( $ यह -> call_hook )
{
वैश्विक $ phpbb_hook ;
अगर ( $ phpbb_hook -> call_hook ( सरणी ( __CLASS__ , __FUNCTION__ ) , $ my_first_parameter , $ my_second_parameter )
{
अगर ( $ phpbb_hook -> hook_return ( सरणी ( __CLASS__ , __FUNCTION__ ) ) )
{
$ $ phpbb_hook -> hook_return_result ( सरणी ( __CLASS__ , __FUNCTION__ ) ) ;
}
}
}
वापसी 'झुका नहीं' ;
}
}
फंक्शन हुकिंग ( और $ हुक , $ प्रथम , $ सेकंड )
{
वापसी 'झुका' ;
}
$ first_object = new my_hookable_object2 ( ) ;
$ second_object = new my_hookable_object2 ( ) ;
$ phpbb_hook -> add_hook ( सरणी ( 'my_hookable_object2' , 'hook_me' ) ) ;
$ phpbb_hook -> रजिस्टर ( सरणी ( 'my_hookable_object2' , 'hook_me' ) , 'hooking' ) ;
// $ First_object के लिए एक ट्रैप को कॉल न करें
$ first_object -> call_hook = false ;
इको $ first_object -> hook_me ( 'पहला' , 'दूसरा' ) । ' ' ;
इको $ सेकंड_बॉजेक्ट -> हुक_मे ( 'पहला' , 'दूसरा' ) । ' ' ;
// आउटपुट:
झुका नहीं
शौकीन

एक अन्य संभावना एक फंक्शन वेरिएबल का उपयोग करना है (जो कि ट्रैप के लिए चर को पार करते समय छोड़ा जा सकता है)

वर्ग my_hookable_object {
फंक्शन ब्लाब्ला ( )
{
}
}
वर्ग my_hookable_object2 my_hookable_object का विस्तार करता है
{
फ़ंक्शन हुक_मे ( $ my_first_parameter , $ my_second_parameter , $ hook_me = true )
{
अगर ( $ हुक_मे )
{
वैश्विक $ phpbb_hook ;
अगर ( $ phpbb_hook -> call_hook ( सरणी ( __CLASS__ , __FUNCTION__ ) , $ my_first_parameter , $ my_second_parameter )
{
अगर ( $ phpbb_hook -> hook_return ( सरणी ( __CLASS__ , __FUNCTION__ ) ) )
{
$ $ phpbb_hook -> hook_return_result ( सरणी ( __CLASS__ , __FUNCTION__ ) ) ;
}
}
}
वापसी 'झुका नहीं' ;
}
}
फंक्शन हुकिंग ( और $ हुक , $ प्रथम , $ सेकंड )
{
वापसी 'झुका' ;
}
$ first_object = new my_hookable_object2 ( ) ;
$ second_object = new my_hookable_object2 ( ) ;
$ phpbb_hook -> add_hook ( सरणी ( 'my_hookable_object2' , 'hook_me' ) ) ;
$ phpbb_hook -> रजिस्टर ( सरणी ( 'my_hookable_object2' , 'hook_me' ) , 'hooking' ) ;
इको $ first_object -> hook_me ( 'पहला' , 'दूसरा' , गलत ) । ' ' ;
इको $ सेकंड_बॉजेक्ट -> हुक_मे ( 'पहला' , 'दूसरा' ) । ' ' ;
// आउटपुट:
झुका नहीं
शौकीन

4. परिणाम लौटना

यह स्पष्ट रूप से निर्धारित करना आवश्यक है कि क्या फ़ंक्शन इंटरसेप्टेड फ़ंक्शन के साथ परिणाम देता है, या निष्पादित करना जारी रखता है। यह अनुप्रयोग की आवश्यकता के कारण हो सकता है और, परिणामस्वरूप, फ़ंक्शन परिणाम को केवल तभी लौटाता है, जब फंसे द्वारा बाधित फ़ंक्शन परिणाम लौटाता है।

केस नंबर 1 - फ़ंक्शन निष्पादन का परिणाम लौटना

कल्पना कीजिए कि निम्नलिखित फ़ंक्शन जाल का समर्थन करता है:

समारोह append_sid ( $ url , $ params = false , $ is_amp = true , $ session_id = false )
वैश्विक $ _SID , $ _EXTRA_URL , $ phpbb_hook ;
// जाल का उपयोग करने वाले डेवलपर्स को करने की आवश्यकता है
// वैश्विक $ _SID और $ _EXTRA_URL अपने में
// फ़ंक्शंस और कुशलता से उन्हें प्रबंधित करें।
// अधिकांश कोड को यहां से कॉपी किया जा सकता है
अगर ( $ phpbb_hook -> call_hook ( __FUNCTION__ , $ url , $ params , $ is_amp , $ session_id ) {
अगर ( $ phpbb_hook -> hook_return ( __FUNCTION__ ) )
{
वापसी $ phpbb_hook -> hook_return_result ( __FUNCTION__ ) ;
}
}
[ ... ]
}

अब आपका कार्य परिणाम वापस करने के तुरंत बाद, append_sid () फ़ंक्शन आपका परिणाम लौटा देगा :

// इंटरसेप्टेड फंक्शन
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false )
{
// संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
'मैं कुछ वापस करने के बाद,' परिशिष्ट () फ़ंक्शन मेरे परिणाम वापस करूँगा ;
}

आपको पिछले फ़ंक्शन के परिणाम प्राप्त करने की क्षमता का उपयोग हमेशा पिछले_हुक_रेल्ट () विधि में करना चाहिए, जो प्रपत्र सरणी ('परिणाम' => [आपका परिणाम]) का एक सरणी लौटाता है।

केस नंबर 2 - सामान्य तौर पर, हम कुछ भी नहीं लौटाते हैं

कभी-कभी अनुप्रयोगों को कुछ वापस करने की आवश्यकता नहीं होती है और इसलिए निम्नलिखित कार्य निष्पादित होते रहेंगे:

समारोह append_sid ( $ url , $ params = false , $ is_amp = true , $ session_id = false )
{
वैश्विक $ _SID , $ _EXTRA_URL , $ phpbb_hook ;
अगर ( $ phpbb_hook -> call_hook ( __FUNCTION__ , $ url , $ params , $ is_amp , $ session_id ) )
{
अगर ( $ phpbb_hook -> hook_return ( __FUNCTION__ ) )
{
वापसी $ phpbb_hook -> hook_return_result ( __FUNCTION__ ) ;
}
}
[ ... ]
}
// इंटरसेप्टेड फंक्शन
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false )
{
// संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
[ ... ]
// मैं बस कुछ चर को अधिलेखित करता हूं और कुछ भी वापस नहीं करता हूं, इसलिए append_sid () फ़ंक्शन कुछ भी वापस नहीं करेगा।
}

नोट: वापस लौटने या न लौटने का निर्णय केवल कॉल के अंत में जाल की श्रृंखला के लिए किया जाता है। उदाहरण के लिए:

// इंटरसेप्टेड फंक्शन
फ़ंक्शन my_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false )
{
// संभावित परिणाम प्राप्त करें
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
// चर $ परिणाम में एक मूल्य नहीं होता है
वापसी 'भरा' ;
}
// इस फ़ंक्शन को my_append_sid () के बाद भी पंजीकृत और निष्पादित किया गया है
फ़ंक्शन my_own_append_sid ( और $ हुक , $ url , $ params = false , $ is_amp = true , $ session_id = false )
{
$ परिणाम = $ हुक -> पिछला_हूक_ल्टल ( 'एपेंड_सिड' ) ;
// चर $ परिणाम 'भरा' के साथ भरा जाएगा
// लेकिन, क्योंकि यदि मैं कुछ भी वापस नहीं करता हूं, तो append_sid () फ़ंक्शन निष्पादित करना जारी रखेगा
}
// दोनों कार्यों को पंजीकृत करने की विधि
$ phpbb_hook -> रजिस्टर ( 'append_sid' , 'my_append_sid' ) ;
$ phpbb_hook -> रजिस्टर ( 'append_sid' , 'my_own_append_sid' ) ;

6. अपनी फ़ाइलों / कक्षाओं / विधियों को एम्बेड करना

सामान्य तौर पर, दो तरीके हैं जिनके बीच आप चुन सकते हैं:

1) फ़ाइल को शामिल / हुक / फ़ोल्डर में जोड़ें। फ़ाइल में हुक_ उपसर्ग होना चाहिए। यह फ़ाइल common.php के अंदर कनेक्ट हो जाएगी, आप अपना ट्रैप पंजीकृत कर सकते हैं, अन्य फ़ाइलों या फ़ंक्शंस को कनेक्ट कर सकते हैं, आदि। यदि आवश्यक हो तो अन्य फ़ाइलों को कनेक्ट करने की सिफारिश की जाती है (उदाहरण के लिए, फ़ंक्शन कॉल के अंदर)।

ध्यान रखें कि आपको कैश साफ़ करने की आवश्यकता है ताकि आपकी नई स्थानांतरित फ़ाइलें phpBB3 द्वारा सुलभ हों।

2) दूसरी विधि उन लोगों के लिए है जो जाल में एक विशेष फ़ाइल रखने के बजाय, phpBB3 कोड को लपेटना चाहते हैं। यह आमतौर पर एप्लिकेशन फ़ाइल के अंदर phpBB फ़ाइलों को शामिल करके किया जाता है। अपने जाल को पंजीकृत करने के लिए आपको एप्लिकेशन में एक फ़ंक्शन बनाने की आवश्यकता है:

// मेरा फ़ंक्शन, जिसे कंस्ट्रक्टर के अंदर निष्पादित किया गया है
समारोह phpbb_hook_register ( और $ हुक )
{
$ हुक -> रजिस्टर ( 'append_sid' , 'my_append_sid' ) ;
}
[ ... ]

मूल पाठ ।

PhpBB3 ट्रैप सिस्टम