PHP RUtils - रूसी पाठ के प्रसंस्करण के लिए एक छोटी सी लाइब्रेरी

पायथन में अपने काम में, मैं अक्सर रूसी पाठ के साथ काम करने के लिए पाइटिल्स पुस्तकालय का उपयोग करता हूं , और पीएचपी में काम करते समय मैं वास्तव में इस पुस्तकालय को याद करता था। शायद मैंने खराब तरीके से खोजा, लेकिन मुझे जो कुछ भी मिला, उसने ऐसे अवसर प्रदान नहीं किए या स्वच्छ कोड के बारे में मेरे विचारों का जवाब नहीं दिया।

और इसलिए, एक बार जब मैंने लाइब्रेरी को पीएचपी में पोर्ट करने का फैसला किया, और अब मैं इसे लोगों के साथ साझा करना चाहता हूं और वास्तव में इसे सुधारने में मदद की उम्मीद करता हूं: मैं सलाह, बग रिपोर्ट और विशेष रूप से अनुरोधों के साथ खुश रहूंगा। पुस्तकालय GitHub पर है: github.com/Andre-487/php_rutils

10.26.2013 से UPD: अब पुस्तकालय संगीतकार के माध्यम से भी उपलब्ध है: packagist.org/packages/andre_487/php_rutils
मैं उन सभी को भी धन्यवाद देना चाहता हूं जिन्होंने पुस्तकालय को बेहतर बनाने और इसे एक स्थिर रिलीज में लाने में मदद की।

पुस्तकालय सुविधाएँ

PHP RUtils - PHP में Pytils पोर्ट। ये रूसी पाठ के साथ काम करने के लिए उपयोगिताओं हैं। उपयोगिताएँ निम्नलिखित मॉड्यूल (वर्गों) में विभाजित हैं:

• अंक - संख्याओं के साथ काम: संज्ञाओं की मात्रा, शब्दों में संख्या, रूबल में धन की मात्रा और शब्दों में कोपेक के आधार पर।
• Dt - तारीखों के साथ काम करें: महीने के रूसी नामों के साथ PHP तारीख प्रारूप का विस्तार, सप्ताह के दिन; समय अवधि (उदा। 24,976 दिन पहले)।
• लिप्यंतरण - लिप्यंतरण, यूआरएल में उपयोग के लिए तार की तैयारी, फ़ाइल नाम।
• टाइपो सादे पाठ के लिए टाइपोग्राफी नियमों का एक छोटा सा सेट है।

कोड उदाहरण

न्यूनाधिक मॉड्यूल

बहुवचन रूप चयन

$variants = array( '', //1 '', //2 '' //5 ); $amount = 15; echo $amount, ' ', RUtils::numeral()->choosePlural($amount, $variants); //Result: 15  echo RUtils::numeral()->getPlural(2, $variants); //Result: 2  

शब्दों में फॉर्म चयन और आउटपुट

 echo RUtils::numeral()->sumString(1234, RUtils::MALE, $variants); //Result:       

शब्दों में एक संख्या लिखना

 $numeral = RUtils::numeral(); echo $numeral->getInWordsInt(100); //Result:  echo $numeral->getInWordsFloat(100.025); //Result:      echo $numeral->getInWords(100.0); //Result:  

रूबल में पैसा निकालना

 echo RUtils::numeral()->getRubles(100.25); //Result:      

Dt मॉड्यूल

आज की तारीख

पैरामीटर \php_rutils\struct\TimeParams उदाहरण के रूप में पारित किए जाते हैं, उन्हें एक सरणी के रूप में पारित करना भी संभव है

 $params = new TimeParams(); $params->date = null; //    $params->format = ' d FY '; $params->monthInflected = true; echo RUtils::dt()->ruStrFTime($params); //Result:  22  2013  

ऐतिहासिक तारीख

पैरामीटर एक सरणी के रूप में पारित किए जाते हैं, फ़ील्ड TimeParams क्लास के समान हैं।
तिथि को मुफ्त प्रारूप में एक स्ट्रिंग के रूप में प्रेषित किया जाता है। दिनांक को यूनिक्स टाइमस्टैम्प के रूप में या DateTime क्लास के उदाहरण के रूप में पास करना भी संभव है।

 $params = array( 'date' => '09-05-1945', 'format' => 'ld FY     - ', 'monthInflected' => true, 'preposition' => true, ); echo RUtils::dt()->ruStrFTime($params); //Result:   9  1945     -  

पूर्व में एक निश्चित तिथि के लिए समय अवधि

इस फ़ंक्शन के लिए समय प्रारूप Dt::ruStrFTime के स्वरूपों के समान हैं।
$accuracy पैरामीटर जानकारी के विस्तार के लिए जिम्मेदार है।

 $toTime = new \DateTime('05-06-1945'); echo RUtils::dt()->distanceOfTimeInWords($toTime); //Result: 24 976   $toTime = strtotime('05-06-1945'); $fromTime = null; //now $accuracy = 3; //, ,  echo RUtils::dt()->distanceOfTimeInWords($toTime, $fromTime, $accuracy); //Result: 24 976 , 11 , 21   

निश्चित तिथियों के बीच की समय अवधि

 $fromTime = '1988-01-01 11:40'; $toTime = '2088-01-01 12:35'; $accuracy = 3; //, ,  echo RUtils::dt()->distanceOfTimeInWords($toTime, $fromTime, $accuracy); //Result:  36 525 , 0 , 55  

अनुवाद मॉड्यूल

 // echo RUtils::translit()->translify(' —   '); //Result: Muha - eto malen'kaya ptichka //  echo RUtils::translit()->detranslify("SCHuka"); //Result:  //    URL'   echo RUtils::translit()->slugify(' —   '); //Result: muha---eto-malenkaya-ptichka 

टाइपो मॉड्यूल

 $text = <<<TEXT ... . .     (   " " № 45)  Weather Forecast (r),      -   +-451F. TEXT; //  echo RUtils::typo()->typography($text); /** * Result: * ... . .     (  « » №45)  Weather Forecast®, *      —   ±451°F. */ //   "extended" echo RUtils::typo()->typography($text, TypoRules::$EXTENDED_RULES); /** * Result: * … . .     (  « » №45)  Weather Forecast®, *      —   ±451 °F. */ //  echo RUtils::typo()->typography($text, array(TypoRules::DASHES, TypoRules::CLEAN_SPACES)); /** * Result: * ... . .     (  " " № 45)  Weather Forecast (r), *      —   +-451F. */ 

इसके अलावा (यह यहां नहीं दिखाया जा सकता है), टाइपो मॉड्यूल गैर-ब्रेकिंग स्पेस (NBSP, THIN NBSP) रखता है। यह मॉड्यूल सादे पाठ के लिए अधिक डिज़ाइन किया गया है, इसलिए विशेष HTML वर्णों का उपयोग नहीं किया जाता है, UTF-8 वर्ण सीधे उपयोग किए जाते हैं।

विवरण

जब मैंने Pytils को पोर्ट किया, तो मैंने सभी कार्यक्षमता को लागू करने और इंटरफेस को पहचानने का प्रयास किया ताकि अन्य Pytils उपयोगकर्ता आसानी से PHP संस्करण का उपयोग कर सकें। इसके अलावा, अधिकांश परीक्षण मामलों को पाइटल परीक्षणों से लिया जाता है। मैंने पाइटल रिपॉजिटरी से कई टिप्पणियां और उदाहरण भी उधार लिए। लेकिन, निश्चित रूप से, मेरे लेखक की दृष्टि और PHP की बारीकियों के संबंध में कुछ "सुधार" हुए।

उदाहरण के लिए, HD :: ruStrFTime विधि के हस्ताक्षर को बदलने और तर्कों की एक बड़ी सूची के बजाय एक संरचना का उपयोग करने का निर्णय लिया गया। पायथन में कोई नाटक नहीं होगा, अगर अचानक डिफ़ॉल्ट मानों के साथ बड़ी संख्या में तर्क समाप्त हो जाते हैं, तो केवल अंतिम परिवर्तन करने की आवश्यकता है - नामित तर्क बचाव में आएंगे; लेकिन अगर PHP में ऐसी ही स्थिति होती है, तो यह एक वास्तविक त्रासदी होगी। और फ़ंक्शन में सभ्य पैरामीटर हैं।

इसके अलावा, चूंकि अक्सर PHP डेवलपर्स किसी फ़ंक्शन के लिए क्लास ऑब्जेक्ट को पास करना पसंद नहीं करते हैं, लेकिन एक सरणी को पास करना पसंद करते हैं, इन सभी मापदंडों को एक सहयोगी सरणी के रूप में पारित करने की क्षमता लागू होती है।

तारीखों के बारे में PHP डेवलपर्स की प्राथमिकताओं को भी ध्यान में रखा जाता है, मैंने यथासंभव उनके साथ काम करने की कोशिश की। जैसा कि आप जानते हैं, समय के साथ, PHP अक्सर दो स्वरूपों में काम करती है: फ्री स्ट्रिंग (02.03.2005, 2005-03-02) और यूनिक्स टाइमपास। DateTime क्लास भी कभी-कभी उपयोग की जाती है। मैंने तय किया कि इन तीनों प्रकारों के साथ काम करने वाले कार्य करने चाहिए। मैंने प्रेषित समय के लिए समय क्षेत्र निर्दिष्ट करने की क्षमता भी जोड़ी।

मैंने सभी सार्वजनिक तरीकों और संरचना क्षेत्रों पर विस्तृत टिप्पणियां लिखीं। इस तथ्य के बावजूद कि पुस्तकालय का उद्देश्य रूसी भाषी दर्शकों के लिए है, मैंने खुद को और पुस्तकालय उपयोगकर्ताओं को अच्छे खुले स्रोत के नियमों को सिखाने के लिए अंग्रेजी भाषा की टिप्पणियों के साथ खुद को अपमानित करने के लिए एक मुश्किल विकल्प बनाया।

लेख में दिए गए सभी उदाहरण वेब सर्वर और कंसोल में निष्पादन के लिए अनुकूलित लिपियों के रूप में उपलब्ध हैं (विंडोज कंसोल इसके cp866 सहित)।

फिलहाल, मैंने अपने पुस्तकालय के लिए संस्करण 0.1 चुना है, लेकिन मुझे उम्मीद है कि इसके लिए उपयोगकर्ता हैं जो इसे आगे विकसित करने में मदद करेंगे, और यह 1.0 संस्करण में मिलेगा, और यहां तक ​​कि, इसे लानत, 2.0।