README

KozyaxTools PHP دا يېزىلغان پروگرامما ياساشتا ئىشلىتىدىغان كەڭ ئىشلىتىشچان ئىقتىدارلار جەملەنگەن قۇرال. بۇ قۇرال ئۇيغۇر تىلىنى قوللايدۇ ۋە زامانىۋى php يىزىشتا كېرەك بولىدىغان كۆپلىگەن فۇنكىيىلەرنى تەمىنلەيدۇ.

ئالاھىدىلىكلار

🔥 ئۈچىنچى تەرەپكە بىقىنمايدىغان - بارلىق فۇنكىيىلەر PHP نىڭ ئۆزىدىكى ئىقتىدارى بىلەن ئىشلەيدۇ
🌍 ئۇيغۇرچە قوللاش - تولۇق ئۇيغۇرچە تىل قوللايدۇ
⚡ يۇقىرى ئىقتىدار - ئالاھىدە ئىشلەش سۈرئىتى ۋە ئاز كود بىلەن كۆپ ئىقتىدارلارنى يىزىش
🛡️ بىخەتەرلىك - بىخەتەرلىك ئەڭ ئاۋۋال ھېسابلىنىپ لايىھەلەنگەن

Composer ئارقىلىق قاچىلاش

composer require kozyaxbiz/kozyax-tools

ئىشلىتىش

<?php
use KozyaxTools\KozyaxTools;
$text = KozyaxTools::cleanUyghurText("  سالام  ");

// رەسىم ئۆلچىمى ئۆزگەرتىش
KozyaxTools::resizeImage('photo.jpg', 800, 600);

// ۋاقىت
$timeAgo = KozyaxTools::timeAgo('2024-01-01');

ۋاقىت(Time & Carbon)

// ھازىرقى ۋاقىت
KozyaxTools::now();
KozyaxTools::now('Y-m-d H:i:s'); // فورماتلىق ۋاقىت

// بۈگۈن
KozyaxTools::today();
KozyaxTools::today('Y-m-d');

// ۋاقىت
KozyaxTools::timeAgo('2024-01-01');
KozyaxTools::timeAgo('2024-01-01', true); // تولۇق ئۇچۇر

// كۈن قوشۇش
KozyaxTools::addDays(7);
KozyaxTools::addDays(-7); // كۈن ئېلىش

// ۋاقىت ئۆلچەش
KozyaxTools::measureTime(function() {
    // كود ئىجرا قىلىش
    sleep(1);
});

// Carbon ۋاقىت ئىشلەش
KozyaxTools::carbon(); // Carbon نىڭ دەك ئىشلەيدۇ

تىكسىت(Strings)

// ئۇيغۇرچە تىكسىتنى تازىلاش
KozyaxTools::cleanUyghurText('  سالام  ');

// تىكسىت قىسقارتىش
KozyaxTools::truncate('بۇ ئۇزۇن تەكىست', 20);
KozyaxTools::truncate('بۇ ئۇزۇن تەكىست', 20, '...');

// URL Slug ياساش
KozyaxTools::createSlug('ئۇيغۇر تىلى پروگرامما');

// خالىغانچە مەخپى نۇمۇر ھاسىللاش 
KozyaxTools::generatePassword(12);
KozyaxTools::generatePassword(16, true);

// خالىغانچە تىكشىت
KozyaxTools::randomString(8);
KozyaxTools::randomString(16, 'abc123');

// Email تەكشۈرۈش
KozyaxTools::validateEmail('test@example.com');
KozyaxTools::isEmail('user@domain.com');

// تىكسىت فورماتلاش
KozyaxTools::camelCase('uyghur_text_processing');
KozyaxTools::kebabCase('UyghurTextProcessing');

// توربەتكە ھۈكۈم قىلىش
KozyaxTools::isUrl('https://example.com');

//يانفۇن نۇمۇرغا ھۈكۈم قىلىش
KozyaxTools::isPhone('10000000000');

رەسىم (Image)

رەسىم يۈكلەش ۋە ئۇچۇر ئېلىش

// رەسىم يۈكلەش
// چۈشەندۈرۈش: رەسىم ھۆججىتىنى يۈكلەپ ئىشلەشكە تەييارلايدۇ
// پارامېتىرلار: $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
KozyaxTools::makeImage('photo.jpg');
KozyaxTools::makeImage('/path/to/image.png');
KozyaxTools::makeImage('https://example.com/image.jpg');

// رەسىم ئۇچۇرى ئېلىش
// چۈشەندۈرۈش: رەسىمنىڭ چوڭلۇقى، تىپى، ھەجمى قاتارلىق ئۇچۇرلارنى قايتۇرىدۇ
// قايتۇرىدىغان قىممەت: array - رەسىم ئۇچۇرلىرى
$imageInfo = KozyaxTools::getImageInfo('photo.jpg');
// قايتۇرىدىغان مەزمۇن:
// [
//     'width' => 1920,      // كەڭلىك (pixel)
//     'height' => 1080,     // ئېگىزلىك (pixel)
//     'type' => 'jpeg',     // رەسىم تىپى
//     'size' => 524288,     // ھۆججەت چوڭلۇقى (بايت)
//     'mime' => 'image/jpeg' // MIME تىپى
// ]

رەسىم چوڭلۇقىنى ئۆزگەرتىش

// رەسىم چوڭلۇقىنى ئۆزگەرتىش
// چۈشەندۈرۈش: رەسىمنىڭ كەڭلىك ۋە ئېگىزلىكىنى بەلگىلەنگەن ئۆلچەمگە ئۆزگەرتىدۇ
// پارامېتىرلار:
//   $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
//   $width (int) - يېڭى كەڭلىك
//   $height (int) - يېڭى ئېگىزلىك
//   $outputPath (string, ئىختىيارى) - ساقلاش يولى، بەلگىلەنمىسە ئەسلى ھۆججەتنى ئالماشتۇرىدۇ
KozyaxTools::resizeImage('photo.jpg', 800, 600);
KozyaxTools::resizeImage('large.png', 400, 300, 'small.png');
KozyaxTools::resizeImage('avatar.jpg', 150, 150, 'avatar_thumb.jpg');

// نىسبەت ساقلاپ چوڭايتىش
// چۈشەندۈرۈش: رەسىمنىڭ نىسبىتىنى ساقلاپ چوڭلۇقىنى ئۆزگەرتىدۇ
KozyaxTools::resizeImageProportional('photo.jpg', 800);
KozyaxTools::resizeImageProportional('photo.jpg', null, 600);

رەسىم كېسىش ۋە ئايلاندۇرۇش

// رەسىم كېسىش
// چۈشەندۈرۈش: رەسىمنىڭ بەلگىلەنگەن رايونىنى كېسىپ ئالىدۇ
// پارامېتىرلار:
//   $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
//   $x (int) - باشلانغۇچ X كوئوردىناتى
//   $y (int) - باشلانغۇچ Y كوئوردىناتى
//   $width (int) - كېسىش كەڭلىكى
//   $height (int) - كېسىش ئېگىزلىكى
KozyaxTools::cropImage('photo.jpg', 100, 100, 200, 200);
KozyaxTools::cropImage('banner.jpg', 0, 50, 800, 300, 'cropped_banner.jpg');

// رەسىم ئايلاندۇرۇش
// چۈشەندۈرۈش: رەسىمنى بەلگىلەنگەن ھالەتكە ئايلاندۇرىدۇ
// پارامېتىرلار:
//   $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
//   $angle (float) - ئايلاندۇرۇش بۇرچىكى
//   $backgroundColor (string, ئىختىيارى) - ئارقا كۆرۈنۈش رەڭگى
KozyaxTools::rotateImage('photo.jpg', 90);
KozyaxTools::rotateImage('photo.jpg', 45, '#ffffff');
KozyaxTools::rotateImage('photo.jpg', -30);

سۇ بەلگىسى ۋە ئېفېكت

// سۇ بەلگىسى قوشۇش
// چۈشەندۈرۈش: رەسىمغا سۇ بەلگىسى (تېكىست) قوشىدۇ
// پارامېتىرلار:
//   $imagePath (string) - ئاساسىي رەسىم يولى
//   $watermarkPath (string) - سۇ بەلگىسى رەسىم يولى
//   $position (string) - ئورنى
//   $opacity (float, اختىيارى) - سۈزۈكلۈك دەرىجىسى
KozyaxTools::watermarkImage('photo.jpg', 'logo.png', 'bottom-right');
KozyaxTools::watermarkImage('photo.jpg', 'logo.png', 'center', 0.7);
KozyaxTools::watermarkImage('photo.jpg', 'watermark.png', 'top-left', 0.5);

// تېكىست سۇ بەلگىسى
// چۈشەندۈرۈش: رەسىمغا تېكىست سۇ بەلگىسى قوشىدۇ
KozyaxTools::addTextWatermark('photo.jpg', '© KOZYAX 2024', 'bottom-right', 'Arial', 16, '#ffffff');

رەڭ ۋە يورۇقلۇق تەڭشەش

// يورۇقلۇق تەڭشەش
// چۈشەندۈرۈش: رەسىمنىڭ يورۇقلۇق دەرىجىسىنى تەڭشەيدۇ
// پارامېتىرلار:
//   $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
//   $level (int) - يورۇقلۇق دەرىجىسى
KozyaxTools::brightnessImage('photo.jpg', 20);
KozyaxTools::brightnessImage('photo.jpg', -30);

// رەڭ قايۇقلۇقى تەڭشەش
// چۈشەندۈرۈش: رەسىمنىڭ رەڭ قايۇقلۇق دەرىجىسىنى تەڭشەيدۇ
// پارامېتىرلار:
//   $imagePath (string) - رەسىم ھۆججىتىنىڭ يولى
//   $level (int) - قايۇقلۇق دەرىجىسى
KozyaxTools::contrastImage('photo.jpg', 15);
KozyaxTools::contrastImage('photo.jpg', -20);

// رەڭ تۆنى ئۆزگەرتىش
// چۈشەندۈرۈش: رەسىمنىڭ رەڭ تۆنىنى ئۆزگەرتىدۇ
KozyaxTools::adjustHue('photo.jpg', 30);

// قان قىزىللىق/يېشىللىق تەڭشەش
KozyaxTools::adjustSaturation('photo.jpg', 25);

رەسىم فىلتېر ۋە ئېفېكت

// قارا-ئاق رەسىم
// چۈشەندۈرۈش: رەسىمنى قارا-ئاق رەسىمگە ئايلاندۇرىدۇ
KozyaxTools::grayscaleImage('photo.jpg');
KozyaxTools::grayscaleImage('color.jpg', 'bw_output.jpg');

// گۇڭگۇرت ئېفېكتى
// چۈشەندۈرۈش: رەسىمغا گۇڭگۇرت ئېفېكتى قوشىدۇ
KozyaxTools::blurImage('photo.jpg', 5);

// ئۆتكۈرلەش فىلتېرى
// چۈشەندۈرۈش: رەسىمنى ئۆتكۈرلەشتۈرىدۇ
KozyaxTools::sharpenImage('photo.jpg');

// سېپىيا ئېفېكتى
// چۈشەندۈرۈش: رەسىمغا كونا سېپىيا رەڭ ئېفېكتى قوشىدۇ
KozyaxTools::sepiaImage('photo.jpg');

// ئەكس ئېفېكتى
KozyaxTools::negativeImage('photo.jpg');

رەسىم ساقلاش ۋە فورمات ئايلاندۇرۇش

// رەسىم ساقلاش
// چۈشەندۈرۈش: ئىشلەنگەن رەسىمنى بەلگىلەنگەن يولغا ساقلايدۇ
// پارامېتىرلار:
//   $imageResource - رەسىم مەنبەسى
//   $outputPath (string) - ساقلاش يولى
//   $quality (int, ئىختىيارى) - سۈپەت دەرىجىسى
KozyaxTools::saveImage($image, 'output.jpg');
KozyaxTools::saveImage($image, 'output.jpg', 90);
KozyaxTools::saveImage($image, 'output.png');

// فورمات ئايلاندۇرۇش
// چۈشەندۈرۈش: رەسىم فورماتىنى ئۆزگەرتىدۇ
KozyaxTools::convertImageFormat('photo.jpg', 'photo.png', 'png');
KozyaxTools::convertImageFormat('image.png', 'image.jpg', 'jpeg', 85);
KozyaxTools::convertImageFormat('pic.bmp', 'pic.webp', 'webp');

// Base64 گە ئايلاندۇرۇش
// چۈشەندۈرۈش: رەسىمنى Base64 تېكىست فورماتىغا ئايلاندۇرىدۇ
$base64 = KozyaxTools::imageToBase64('photo.jpg');
// قايتۇرىدىغان قىممەت: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."

// Base64 دىن رەسىم ھاسىللاش
KozyaxTools::base64ToImage($base64String, 'decoded_image.jpg');

كۆپ رەسىم ئىشلەش

// كۆپ رەسىم چوڭلۇق ئۆزگەرتىش
// چۈشەندۈرۈش: بىر قانچە رەسىمنىڭ چوڭلۇقىنى بىرلا ۋاقىتتا ئۆزگەرتىدۇ
$images = ['photo1.jpg', 'photo2.jpg', 'photo3.jpg'];
KozyaxTools::batchResizeImages($images, 800, 600, 'thumbnails/');

// كۆپ رەسىم فورمات ئايلاندۇرۇش
KozyaxTools::batchConvertImages('input/', 'output/', 'jpg', 'png');

// رەسىم كىچىك نۇسخا ھاسىللاش
// چۈشەندۈرۈش: رەسىمنىڭ كىچىك نۇسخىسىنى ھاسىللايدۇ
KozyaxTools::generateThumbnail('large_photo.jpg', 'thumb.jpg', 200, 200);
KozyaxTools::generateThumbnail('image.png', 'thumb.png', 150, 150, true);

بىخەتەرلىك (Security)

// مەخپى نۇمۇر شىفىرلاش
KozyaxTools::hashPassword('my_password');

// مەخپى نۇمۇر تەكشۈرۈش
KozyaxTools::verifyPassword('my_password', $hash);

// مەلۇمات شىفىرلاش
KozyaxTools::encrypt('مەخپىي مەلۇمات', 'شىفىر_ئاچقۇچى');

// مەلۇمات يېشىش
KozyaxTools::decrypt($encryptedData, 'شىفىر_ئاچقۇچى');

// بىخەتەر Token ھاسىللاش
KozyaxTools::generateSecureToken(32);

// API ئاچقۇچى ھاسىللاش
KozyaxTools::generateApiKey();

// خالىغانچە سان
KozyaxTools::randomNumber(1000, 9999);

// Hash تەكشۈرۈش
KozyaxTools::verifyHash('data', $hash);

ھۆججەت سىستېمىسى (Filesystem)

// ھۆججەت يېزىش
KozyaxTools::writeFile('document.txt', 'مەزمۇن');

// ھۆججەت ئوقۇش
KozyaxTools::readFile('document.txt');

// ھۆججەت بار-يوقلۇقىغا ھۈكۈم قىلىش
KozyaxTools::fileExists('document.txt');

// ھۆججەت كۆچۈرۈش
KozyaxTools::copyFile('source.txt', 'backup.txt');

// ھۆججەت يۆتكەش
KozyaxTools::moveFile('old.txt', 'new.txt');

// ھۆججەت ئۆچۈرۈش
KozyaxTools::deleteFile('unwanted.txt');

// مۇندەرىجە قۇرۇش
KozyaxTools::createDirectory('projects/new');

// مۇندەرىجە تىزىملىكى
KozyaxTools::listFiles('documents', true);

// ھۆججەت چوڭلۇقى
KozyaxTools::getFileSize('document.txt');

// ھۆججەت تىپى
KozyaxTools::getFileMimetype('document.pdf');

Cache سىستېمىسى (Cache)

// Cache ساقلاش
KozyaxTools::cacheSet('key', 'value', 3600);

// Cache ئۇقۇش
KozyaxTools::cacheGet('key');

// Cache بار-يوقلۇقىغا ھۈكۈم قىلىش
KozyaxTools::cacheHas('key');

// Cache ئۆچۈرۈش
KozyaxTools::cacheDelete('key');

// Cache تازىلاش
KozyaxTools::cacheClear();

// Cache كۈچكە ئىگە ھالىتى
KozyaxTools::cacheHealthCheck();

// Cache ھالىتى
KozyaxTools::cacheStats();

سانلىق مەلۇمات (Database)

// ساندان تەڭشەك
KozyaxTools::configurePdo('default', $config);

// ئۇچۇر تەكشۈرۈش
KozyaxTools::dbFetchAll('SELECT * FROM users');

// بىرتال تەكشۈرۈش
KozyaxTools::dbFetchOne('SELECT * FROM users WHERE id = ?', [1]);

// ئۇچۇر يىزىش
KozyaxTools::dbInsert('users', ['name' => 'Ali', 'email' => 'ali@test.com']);

// ئۇچۇر يىڭىلاش
KozyaxTools::dbUpdate('users', ['name' => 'Alim'], 'id = ?', [1]);

// ئۇچۇر ئۆچۈرۈش
KozyaxTools::dbDelete('users', 'id = ?', [1]);

// سانلار ھېسابلاش
KozyaxTools::dbCount('users', 'status = ?', [1]);

// تىزىملىككە ئىرىشىش
KozyaxTools::dbGetList('users', ['limit' => 10]);

ئېلېكترونلۇق خەت (Email)

// Email ئەۋەتىش
KozyaxTools::sendEmail('user@test.com', 'Subject', 'Content');

// Email قېلىپى
KozyaxTools::sendEmailTemplate('welcome', 'user@test.com', ['name' => 'Ali']);

// كۆپ Email ئەۋەتىش
KozyaxTools::sendBulkEmail($recipients, 'Subject', 'Content');

// Email تەڭشەك
KozyaxTools::configureEmail($config);

// Email قېلىپ قوشۇش
KozyaxTools::addEmailTemplate('welcome', 'Welcome {{name}}!', $body);

Log سىستېمىسى (Log)

// ئاددىي Log
KozyaxTools::log('info', 'User logged in');

// Debug Log
KozyaxTools::logDebug('Debug information');

// خاتالىق Log
KozyaxTools::logError('Error occurred', ['error' => $e->getMessage()]);

// ئاگاھلاندۇرۇش Log
KozyaxTools::logWarning('Warning message');

// مۇھىم Log
KozyaxTools::logCritical('Critical issue');

// Log تەڭشەك
KozyaxTools::configureLog(['log_level' => 'debug']);

HTTP ئۇلىنىش (Http)

// GET شەكلى
KozyaxTools::httpGet('https://api.example.com/users');

// POST شەكلى 
KozyaxTools::httpPost('https://api.example.com/users', $data);

// JSON شەكلى
KozyaxTools::httpJson('POST', 'https://api.example.com', $jsonData);

// ھۆججەت يوللاش
KozyaxTools::httpUpload('https://api.example.com/upload', ['file' => $filePath]);

// ھۆججەت چۈشۈرۈش
KozyaxTools::httpDownload('https://example.com/file.zip', 'local.zip');

// HTTP تەڭشەك
KozyaxTools::configureHttp(['timeout' => 30]);

XML ئىشلەش (Xml)

// XML ھۆججىتى قۇرۇش
KozyaxTools::createXml('root');

// XML تەھلىل
KozyaxTools::loadXml($xmlString);

// RSS ھاسىللاش
KozyaxTools::createRSS('سەرلاۋھا', 'https://example.com', 'تەسۋىرلەش', $items);

// Array نى XML غا ئايلاندۇرۇش
KozyaxTools::arrayToXml($array, 'root');

تور بەت يۈزىگە ئىرىشىش (QueryHelper)

// بەت مەزمۇنى ئېلىش
KozyaxTools::queryWeb('https://example.com');

// ئۇلانما ئېلىش
KozyaxTools::getLinks('https://example.com');

// رەسىملەرگە ئېرىشىش
KozyaxTools::getImages('https://example.com');

// بەت تىمىسىغا ئىرىشىش
KozyaxTools::getPageTitle('https://example.com');

// بەت ئۇچۇرى
KozyaxTools::getPageMeta('https://example.com');

SMS ئۇچۇر (SMS)

SMS تەڭشەش

// چۈشەندۈرۈش: SMS ئۇچۇر ئەۋەتىش قوشۇش ۋە تەڭشەش
// قوللايدىغان بىكەتلەر: 短信宝、阿里云、腾讯云、华为云、云片网、极光、聚合数据、梦网云通讯、SUBMAIL、网易云信、智慧云信、Unisms

// 短信宝 (SmsBao) تەڭشەش
KozyaxTools::addSmsProvider('smsbao', [
    'type' => 'smsbao',
    'username' => 'your_username',
    'password' => 'your_password'
]);

// 阿里云SMS تەڭشەش
KozyaxTools::addSmsProvider('aliyun', [
    'type' => 'aliyun',
    'access_key' => 'your_access_key',
    'access_secret' => 'your_access_secret',
    'sign_name' => 'your_sign_name',
    'template_code' => 'SMS_123456'
]);

// 腾讯云SMS تەڭشەش
KozyaxTools::addSmsProvider('tencent', [
    'type' => 'tencent',
    'secret_id' => 'your_secret_id',
    'secret_key' => 'your_secret_key',
    'sdk_app_id' => '1400000000',
    'sign_name' => 'your_sign_name',
    'template_id' => '123456'
]);

// 华为云SMS تەڭشەش
KozyaxTools::addSmsProvider('huawei', [
    'type' => 'huawei',
    'app_key' => 'your_app_key',
    'app_secret' => 'your_app_secret',
    'sender' => '1234567890',
    'template_id' => 'template_id',
    'signature' => 'signature',
    'endpoint' => 'https://rtcsms.ap-southeast-1.myhuaweicloud.com:10743'
]);

// 云片网 تەڭشەش
KozyaxTools::addSmsProvider('yunpian', [
    'type' => 'yunpian',
    'apikey' => 'your_apikey'
]);

// 极光SMS تەڭشەش
KozyaxTools::addSmsProvider('jiguang', [
    'type' => 'jiguang',
    'app_key' => 'your_app_key',
    'master_secret' => 'your_master_secret',
    'temp_id' => 123456
]);

// 聚合数据SMS تەڭشەش
KozyaxTools::addSmsProvider('juhe', [
    'type' => 'juhe',
    'key' => 'your_key',
    'tpl_id' => '123456'
]);

// SUBMAIL تەڭشەش
KozyaxTools::addSmsProvider('submail', [
    'type' => 'submail',
    'appid' => 'your_appid',
    'appkey' => 'your_appkey',
    'project' => 'your_project'
]);

// 网易云信 تەڭشەش
KozyaxTools::addSmsProvider('netease', [
    'type' => 'netease',
    'app_key' => 'your_app_key',
    'app_secret' => 'your_app_secret',
    'template_id' => '123456'
]);

// 智慧云信 تەڭشەش
KozyaxTools::addSmsProvider('zhihuiyun', [
    'type' => 'zhihuiyun',
    'account' => 'your_account',
    'password' => 'your_password'
]);

// Unisms تەڭشەش
KozyaxTools::addSmsProvider('unisms', [
    'type' => 'unisms',
    'userid' => 'your_userid',
    'account' => 'your_account',
    'password' => 'your_password'
]);

// 梦网云通讯 تەڭشەش
KozyaxTools::addSmsProvider('montnets', [
    'type' => 'montnets',
    'userid' => 'your_userid',
    'password' => 'your_password'
]);

// سىناق پروۋايدېرى - Mock provider for testing
KozyaxTools::addSmsProvider('mock', [
    'type' => 'mock',
    'log_file' => 'sms_mock.log' // اختىيارى
]);

SMS ئەۋەتىش

// ئاددىي SMS ئەۋەتىش
// چۈشەندۈرۈش: بەلگىلەنگەن تېلېفون نومۇرىغا SMS ئۇچۇر ئەۋەتىدۇ
// پارامېتىرلار:
//   $phone (string) - تېلېفون نومۇرى
//   $message (string) - ئۇچۇر مەزمۇنى
//   $provider (string) - پروۋايدېر نامى
$result = KozyaxTools::sendSms('10000000000', 'سالام ئەلەيكۇم!', 'smsbao');

// نەتىجىنى تەكشۈرۈش
if ($result['success']) {
    echo "SMS ئەۋەتىش مۇۋەپپەقىيەتلىك!";
    echo "ئۇچۇر ID: " . $result['message_id'];
} else {
    echo "SMS ئەۋەتىش مەغلۇب بولدى: " . $result['error'];
    echo "خاتالىق كودى: " . $result['code'];
}

// خەتنى ئېنگلىزچىدا ئەۋەتىش
$result = KozyaxTools::sendSms('10000000000', '【测试】您的验证码是123456', 'smsbao');

// خاتالىق ئۇچۇرى تەپسىلىي
// قايتۇرىدىغان مەزمۇن:
// [
//     'success' => true/false,     // مۇۋەپپەقىيەتلىك بولدى-يوق
//     'message_id' => 'xxxx',      // ئۇچۇر ID
//     'provider' => 'smsbao',      // پروۋايدېر نامى
//     'code' => '0',               // قايتۇرۇش كودى
//     'error' => null,             // خاتالىق ئۇچۇرى
//     'raw_response' => 'xxxx'     // ئەسلى جاۋاب
// ]

تەستىق كودى فۇنكىيىسى

// تەستىقلاش كودى ئەۋەتىش
// چۈشەندۈرۈش: تاسادۇپىي تەستىقلاش كودى ھاسىللاپ ئەۋەتىدۇ
// پارامېتىرلار:
//   $phone (string) - تېلېفون نومۇرى
//   $length (int) - كود ئۇزۇنلۇقى (سۈكۈتتىكى: 6)
//   $provider (string) - پروۋايدېر نامى
$codeResult = KozyaxTools::sendVerificationCode('10000000000', 6, 'smsbao');

if ($codeResult['success']) {
    echo "تەستىقلاش كودى ئەۋەتىلدى!";
    echo "ھاسىللانغان كود: " . $codeResult['code']; // بۇ كود نىڭ پەقەت سىناق مەقسىتىدە
} else {
    echo "تەستىقلاش كودى ئەۋەتىش مەغلۇب بولدى: " . $codeResult['error'];
}

// تەستىقلاش كودىنى تەكشۈرۈش
// چۈشەندۈرۈش: ئىشلەتكۈچى كىرگۈزگەن كودنى تەكشۈرىدۇ
// پارامېتىرلار:
//   $phone (string) - تېلېفون نومۇرى
//   $inputCode (string) - ئىشلەتكۈچى كىرگۈزگەن كود
$verifyResult = KozyaxTools::verifyCode('10000000000', '123456');

if ($verifyResult['success']) {
    echo "تەستىقلاش مۇۋەپپەقىيەتلىك!";
} else {
    echo "تەستىقلاش مەغلۇب بولدى: " . $verifyResult['error'];
}

$result8Digit = KozyaxTools::sendVerificationCode('10000000000', 8, 'aliyun');
$result4Digit = KozyaxTools::sendVerificationCode('10000000000', 4, 'tencent');

كۆپ SMS ئەۋەتىش

// كۆپ SMS ئەۋەتىش
// چۈشەندۈرۈش: بىر قانچە تېلېفون نومۇرىغا ئوخشاش ئۇچۇر ئەۋەتىدۇ
// پارامېتىرلار:
//   $recipients (array) - تېلېفون نومۇرلىرى تىزىملىكى
//   $message (string) - ئۇچۇر مەزمۇنى
//   $provider (string) - بەت نامى
$phones = ['10000000000', '111111111111', '10000000000'];
$message = '【通知】系统维护将于今晚22:00开始，请及时保存数据。';

$batchResults = KozyaxTools::sendBatch($phones, $message, 'yunpian');

// نەتىجىلەرنى تەكشۈرۈش
foreach ($batchResults as $phone => $result) {
    if ($result['success']) {
        echo "{$phone}: ئەۋەتىش مۇۋەپپەقىيەتلىك\n";
    } else {
        echo "{$phone}: ئەۋەتىش مەغلۇب بولدى - {$result['error']}\n";
    }
}

// ماس ئۇچۇرى ئەۋەتىش
$marketingList = ['10000000000', '10000000000', '111111111111'];
$marketingMessage = '【优惠】新用户注册即送100元优惠券，仅限今日！详情访问 http://example.com';
$results = KozyaxTools::sendBatch($marketingList, $marketingMessage, 'jiguang');

SMS ھالىتىنى باشقۇرۇش

// SMS ھالىتىنى ئېلىش
// چۈشەندۈرۈش: ھازىرقى SMS سىستېمىسىنىڭ ھالىتى ۋە مەلۇماتى
$stats = KozyaxTools::getStatistics();

echo "تەڭشەلگەن سانى: " . $stats['total_providers'] . "\n";
echo "قوللايدىغان تىپلىرى: " . implode(', ', $stats['available_types']) . "\n";
echo "ھازىرقى تەستىقلاش كودى سانى: " . $stats['verification_codes_count'] . "\n";

// قوللايدىغان بارلىق بەتلەر تىزىملىكى
// - smsbao (短信宝)
// - aliyun (阿里云)
// - tencent (腾讯云)
// - huawei (华为云)
// - yunpian (云片网)
// - jiguang (极光)
// - juhe (聚合数据)
// - montnets (梦网云通讯)
// - submail (SUBMAIL)
// - netease (网易云信)
// - zhihuiyun (智慧云信)
// - unisms (Unisms)
// - mock (模拟测试)

خاتالىق بىلەن بىر تەرەپ قىلىش

// تولۇق خاتالىق بىلەن بىر تەرەپ قىلىش
try {
    $result = KozyaxTools::sendSms('10000000000', 'تەست ئۇچۇر', 'smsbao');
    
    if (!$result['success']) {
        // خاتالىق تىپىگە قاراپ بىر تەرەپ قىلىش
        switch ($result['code']) {
            case '30':
                echo "خاتالىق: مەخپى نۇمۇر خاتا، تەكشۈرۈپ قايتا سىناڭ";
                break;
            case '40':
                echo "خاتالىق: ھېسابات مەۋجۇت ئەمەس";
                break;
            case '41':
                echo "خاتالىق: ھېسابات قالدۇقى يېتىشمەيدۇ";
                break;
            case '43':
                echo "خاتالىق: IP ئادرېس چەكلىمىسى";
                break;
            case '50':
                echo "خاتالىق: ئۇچۇر مەزمۇنىدا سەزگۈر سۆزلەر بار";
                break;
            case '51':
                echo "خاتالىق: تېلېفون نومۇرى فورماتى خاتا";
                break;
            default:
                echo "نامەلۇم خاتالىق: " . $result['error'];
                break;
        }
        
        // تەپسىلىي خاتالىق ئۇچۇرى
        echo "\nتەپسىلىي ئۇچۇر:\n";
        echo "بەت: " . $result['provider'] . "\n";
        echo "خاتالىق كودى: " . $result['code'] . "\n";
        echo "ئەسلى جاۋاب: " . $result['raw_response'] . "\n";
    }
    
} catch (Exception $e) {
    echo "سىستېما خاتالىقى: " . $e->getMessage();
}

ئىلغار ئىشلىتىش

// كۆپ بەت ئارقىلىق ئەۋەتىش
function sendSmsWithFallback($phone, $message) {
    $providers = ['smsbao', 'aliyun', 'tencent', 'yunpian'];
    
    foreach ($providers as $provider) {
        try {
            $result = KozyaxTools::sendSms($phone, $message, $provider);
            if ($result['success']) {
                return $result;
            }
        } catch (Exception $e) {
            continue; // Try next provider
        }
    }
    
    throw new Exception('بارلىق بەت ئارقىلىق ئەۋەتىش مەغلۇب بولدى');
}

// نەتىجە
$result = sendSmsWithFallback('10000000000', 'مۇھىم ئۇچۇر');

// ۋاقىت بىلەن چەكلەنگەن تەستىقلاش كودى
class SmsVerification {
    public static function sendTimedCode($phone, $expireMinutes = 5) {
        $result = KozyaxTools::sendVerificationCode($phone, 6, 'smsbao');
        
        if ($result['success']) {
            // كودنى Cache غا ساقلاش
            $expireTime = time() + ($expireMinutes * 60);
            KozyaxTools::cacheSet("verify_code_{$phone}", [
                'code' => $result['code'],
                'expire' => $expireTime
            ], $expireMinutes * 60);
        }
        
        return $result;
    }
    
    public static function verifyTimedCode($phone, $inputCode) {
        $stored = KozyaxTools::cacheGet("verify_code_{$phone}");
        
        if (!$stored) {
            return ['success' => false, 'error' => 'تەستىقلاش كودى تېپىلمىدى ياكى ۋاقتى ئۆتۈپ كەتتى'];
        }
        
        if ($stored['code'] === $inputCode) {
            KozyaxTools::cacheDelete("verify_code_{$phone}");
            return ['success' => true, 'message' => 'تەستىقلاش مۇۋەپپەقىيەتلىك'];
        }
        
        return ['success' => false, 'error' => 'تەستىقلاش كودى خاتا'];
    }
}

// ئىشلىتىش
KozyaxTools::sendTimedCode('10000000000', 10);
$verifyResult = SmsVerification::verifyTimedCode('10000000000', '123456');

ۋەزىپە (Async)

// ۋەزىپە قوشۇش
KozyaxTools::addTask('task1', function() { return 'result'; });

// بارلىق ۋەزىپىنى ئىجرا قىلىش
KozyaxTools::runAllTasks();

// ھەممىنى ئىجرا قىلىش
KozyaxTools::runTasksParallel();

// ۋەزىپە ھالىتى
KozyaxTools::getTaskStatus();

// ۋەزىپە تازىلاش
KozyaxTools::clearAsyncTasks();

QR Code (QRCode)

// QR Code ھاسىللاش
KozyaxTools::generateQRCode('123456');

// QR Code ئوقۇش
KozyaxTools::readQRCode('qrcode.png');
KozyaxTools::detectQRCode('qrcode.png');

// QR Code PNG
KozyaxTools::qrCodeToPng($matrix, ['pixel_size' => 10]);

// QR Code HTML
KozyaxTools::qrCodeToHtml($matrix);

// QR Code ASCII
KozyaxTools::qrCodeToAscii($matrix);

// QR Code ئۇچۇرى
KozyaxTools::getQRCodeInfo($matrix);

// QR Code ھۆججەتگە ساقلاش
KozyaxTools::saveQRCodeToFile($matrix, 'qrcode.png');

PHP كود ھاسىللاش (PhpGenerator)

// سىنىپ قۇرۇش
KozyaxTools::createClass('User');

// Interface قۇرۇش
KozyaxTools::createInterface('UserInterface');

// Trait قۇرۇش
KozyaxTools::createTrait('Timestampable');

// Method قوشۇش
KozyaxTools::createMethod('getName', $config);

// Property قوشۇش
KozyaxTools::createProperty('name', $config);

// Namespace قۇرۇش
KozyaxTools::createNamespace('App\Models');

// PHP ھۆججەت ھاسىللاش
KozyaxTools::generatePhpFile($namespace, $classes);

// PHP قىممەت فورماتلاش
KozyaxTools::formatPhpValue($value);
KozyaxTools::formatPhpArray($array);

ئۇچۇر سىستېمىسى (Notification)

// ئۇچۇر ئەۋەتىش
KozyaxTools::sendNotification('user@test.com', 'template', $data);

// كۆپ ئۇچۇر
KozyaxTools::sendBulkNotification($recipients, 'template', $data);

// ۋاقىت بىلەن ئەۋەتىش
KozyaxTools::sendNotificationLater($to, 'template', $data, 300);

// ئۇچۇر Channel قوشۇش
KozyaxTools::addNotificationChannel('email', $config);

// ئۇچۇر قېلىپ
KozyaxTools::addNotificationTemplate('welcome', $template);

// ئۇچۇر تارىخى - Notification history
KozyaxTools::getNotificationHistory('user@test.com');

// ئۇچۇر ھالىتى - Notification stats
KozyaxTools::getNotificationStats();

Event سىستېمىسى

// Event تىڭشىغۇچ
KozyaxTools::attachEvent('user.login', $callback);

// Event قوزغىتىش
KozyaxTools::triggerEvent('user.login', $target, $params);

// Event چىقىرىش
KozyaxTools::detachEvent('user.login', $listenerId);

//ئوچۇق مەيدان پائالىيىتى
KozyaxTools::attachWildcardEvent('user.*', $callback);

// Event ھالىتى
KozyaxTools::getEventStatistics();

// Event تىڭشىغۇچ تازىلاش
KozyaxTools::clearEventListeners();

ئۇچۇر تەھلىلى

// ئۇچۇر گۇرۇپپىلاش
KozyaxTools::groupBy($data, 'category');

// ئۇچۇر تەرتىپلەش
KozyaxTools::sortBy($data, 'name', 'asc');

// ئۇچۇرغا ئىرىىشش
KozyaxTools::pluck($data, 'name', 'id');

// ھالەت
KozyaxTools::stats($numbers);

// ئوتتۇرىچە
KozyaxTools::calculateAverage($numbers);

// CSV غا ئايلاندۇرۇش
KozyaxTools::toCsv($data, 'export.csv');

// CSV ئوقۇش
KozyaxTools::fromCsv('import.csv', true);

ۋەقە ئايلانمىسى (EventLoop)

// Event Loop ئىجرا قىلىش
KozyaxTools::runEventLoop();

// Event Loop توختىتىش
KozyaxTools::stopEventLoop();

// Timer قوشۇش
KozyaxTools::addTimer(5, function() { echo 'ۋاقىت تۈگىدى!'; });

// دەۋىرىي
KozyaxTools::addPeriodicTimer(10, $callback);

// Timer بىكار قىلىش
KozyaxTools::cancelTimer($timerId);

// HTTP Server قۇرۇش
KozyaxTools::createHttpServer('127.0.0.1', 8080, $requestHandler);

// TCP Client قۇرۇش
KozyaxTools::createTcpClient('127.0.0.1', 8080, $onConnect, $onData);

// بىربىرلەپ ئىجرا بۇلىغان فونكىسىيە
KozyaxTools::readFileAsync('file.txt', $callback);
KozyaxTools::writeFileAsync('file.txt', 'content', $callback);

// Process قوزغىتىش
KozyaxTools::spawnProcess('ls -la', $onData, $onExit);

سىستېما ۋە ياردەمچى فۇنكىيىلىرى (System & Functions)

// خاتىرە ئىشلىتىش
KozyaxTools::getMemoryUsage(true); // فورماتلىق

// ئىجرا ۋاقتى
KozyaxTools::getExecutionTime();

// PHP نەشرى
KozyaxTools::getPhpVersion();

// Debug ئۇچۇر
KozyaxTools::dump($variable1, $variable2);

// پىرسەنت
KozyaxTools::percentage(50, 200); // 25%

// بوشلۇق ئارىلىقىدا تەكشۈرۈش
KozyaxTools::between(15, 10, 20); // true

// JSON ھۆججەت ئىشلەش
KozyaxTools::saveJson('data.json', $array);
$data = KozyaxTools::loadJson('data.json');

// ھۆججەت چوڭلۇقى ھىساپلاش
KozyaxTools::formatFileSize(1024); // "1 KB"

// ھۆججەت كېڭەيتمىسى
KozyaxTools::getFileExtension('document.pdf'); // "pdf"

kozyaxbiz / kozyax-tools

Maintainers

Details