{"k1": 1.5, "b": 0.75, "avg_len": 139.1230940870212, "n_docs": 2689, "doc_len": [118, 92, 128, 42, 126, 123, 91, 124, 130, 69, 82, 43, 70, 60, 68, 68, 50, 54, 108, 57, 114, 144, 117, 93, 110, 130, 95, 132, 99, 45, 91, 110, 124, 79, 198, 107, 35, 223, 121, 67, 96, 119, 67, 198, 83, 107, 44, 129, 79, 135, 88, 93, 109, 108, 81, 86, 94, 124, 50, 222, 107, 91, 63, 48, 68, 153, 155, 135, 38, 117, 45, 66, 115, 127, 109, 305, 83, 74, 111, 69, 72, 171, 96, 222, 173, 22, 180, 125, 115, 242, 91, 52, 117, 19, 115, 104, 134, 131, 54, 76, 94, 228, 218, 132, 158, 75, 131, 107, 90, 117, 94, 81, 45, 99, 110, 91, 94, 90, 121, 119, 98, 42, 117, 236, 97, 72, 71, 118, 96, 109, 161, 118, 150, 122, 41, 153, 85, 112, 185, 149, 96, 43, 54, 127, 392, 59, 262, 51, 132, 128, 68, 165, 94, 97, 113, 284, 107, 225, 109, 88, 104, 88, 117, 174, 104, 46, 218, 184, 130, 52, 108, 116, 121, 109, 89, 93, 95, 66, 104, 89, 228, 101, 114, 89, 94, 56, 155, 185, 109, 57, 199, 106, 109, 267, 72, 154, 115, 103, 98, 52, 25, 88, 72, 23, 118, 101, 118, 27, 220, 42, 76, 183, 184, 287, 282, 45, 111, 32, 106, 36, 126, 13, 168, 91, 27, 66, 63, 114, 173, 121, 30, 54, 68, 89, 61, 85, 64, 92, 50, 87, 34, 131, 25, 110, 243, 341, 78, 80, 99, 73, 206, 154, 92, 103, 109, 91, 71, 87, 104, 57, 212, 93, 71, 53, 107, 53, 66, 59, 109, 381, 241, 85, 58, 117, 113, 97, 113, 24, 59, 72, 125, 72, 106, 325, 71, 64, 192, 85, 59, 112, 23, 114, 98, 141, 218, 137, 91, 117, 98, 101, 74, 74, 85, 45, 85, 123, 70, 63, 98, 115, 65, 67, 67, 111, 97, 100, 99, 94, 110, 87, 95, 101, 33, 109, 88, 67, 120, 10, 374, 146, 133, 84, 121, 80, 87, 43, 103, 107, 113, 200, 71, 23, 127, 107, 97, 119, 87, 50, 121, 44, 91, 108, 80, 197, 205, 235, 265, 30, 67, 106, 72, 43, 137, 87, 125, 98, 52, 85, 42, 72, 58, 67, 66, 102, 77, 55, 133, 123, 35, 111, 104, 91, 253, 294, 27, 472, 419, 215, 313, 180, 121, 168, 92, 127, 106, 139, 100, 57, 219, 43, 133, 16, 113, 160, 52, 90, 154, 527, 129, 47, 112, 62, 150, 77, 77, 239, 186, 157, 42, 154, 42, 126, 121, 215, 151, 160, 94, 55, 124, 83, 298, 92, 53, 119, 113, 103, 51, 113, 70, 89, 101, 65, 114, 123, 104, 128, 103, 140, 68, 154, 172, 103, 61, 94, 124, 98, 129, 45, 162, 103, 105, 102, 97, 113, 111, 46, 81, 47, 104, 102, 84, 119, 56, 100, 55, 103, 97, 101, 78, 111, 145, 127, 47, 146, 124, 168, 91, 106, 106, 154, 381, 107, 113, 194, 418, 36, 172, 98, 127, 75, 20, 127, 97, 94, 274, 91, 209, 36, 138, 130, 42, 111, 177, 98, 86, 78, 113, 93, 274, 85, 161, 152, 36, 112, 132, 104, 145, 55, 68, 102, 193, 89, 114, 120, 43, 168, 49, 121, 103, 82, 160, 58, 87, 114, 94, 85, 152, 241, 30, 643, 127, 476, 110, 87, 121, 47, 106, 83, 106, 77, 111, 90, 96, 63, 57, 98, 68, 87, 120, 129, 49, 98, 124, 66, 134, 55, 122, 73, 163, 78, 132, 63, 253, 227, 139, 171, 86, 77, 108, 187, 98, 40, 92, 114, 218, 54, 184, 105, 54, 170, 114, 129, 84, 116, 161, 82, 141, 29, 281, 116, 181, 23, 227, 99, 128, 226, 82, 114, 62, 102, 110, 87, 115, 45, 107, 109, 76, 68, 58, 53, 91, 39, 84, 80, 90, 101, 39, 196, 114, 66, 107, 89, 92, 89, 47, 113, 341, 29, 157, 103, 26, 124, 79, 107, 132, 81, 117, 103, 126, 105, 90, 170, 97, 123, 104, 157, 71, 127, 124, 113, 107, 125, 82, 107, 208, 129, 319, 281, 98, 65, 116, 134, 125, 108, 54, 113, 60, 163, 78, 50, 76, 95, 115, 104, 82, 122, 88, 126, 98, 46, 150, 79, 608, 119, 56, 289, 60, 215, 120, 110, 115, 152, 29, 45, 111, 67, 126, 124, 96, 47, 163, 38, 130, 52, 143, 67, 82, 101, 78, 133, 79, 59, 80, 66, 60, 88, 225, 85, 137, 115, 93, 118, 97, 97, 105, 95, 82, 92, 126, 136, 102, 70, 101, 190, 115, 112, 88, 87, 99, 113, 73, 53, 235, 95, 105, 118, 111, 108, 140, 120, 129, 107, 122, 104, 89, 259, 71, 106, 150, 106, 243, 88, 68, 163, 98, 110, 128, 85, 104, 134, 122, 35, 122, 122, 45, 101, 122, 67, 117, 32, 234, 30, 144, 44, 137, 136, 221, 101, 52, 117, 96, 82, 94, 125, 135, 144, 72, 75, 112, 70, 188, 100, 147, 61, 128, 121, 221, 175, 99, 81, 79, 85, 65, 72, 123, 39, 137, 90, 107, 464, 80, 165, 78, 98, 118, 138, 94, 89, 109, 113, 111, 59, 85, 98, 104, 66, 118, 107, 125, 33, 165, 47, 94, 93, 187, 176, 250, 64, 81, 66, 98, 11, 153, 138, 71, 117, 125, 65, 102, 36, 83, 49, 99, 100, 61, 96, 118, 124, 59, 213, 109, 108, 113, 88, 126, 138, 193, 133, 87, 113, 84, 116, 104, 58, 136, 84, 114, 122, 124, 132, 133, 77, 129, 84, 83, 46, 144, 53, 225, 34, 104, 90, 84, 174, 114, 103, 106, 91, 156, 101, 47, 119, 97, 35, 90, 98, 104, 96, 119, 111, 90, 81, 112, 100, 44, 51, 164, 76, 103, 38, 126, 296, 157, 92, 90, 81, 149, 110, 97, 52, 118, 43, 76, 93, 109, 34, 80, 74, 111, 81, 119, 24, 117, 50, 380, 121, 54, 124, 91, 71, 112, 100, 87, 111, 95, 107, 103, 162, 101, 119, 56, 97, 97, 82, 108, 119, 144, 107, 115, 93, 65, 612, 227, 102, 107, 101, 117, 96, 101, 95, 102, 124, 122, 99, 115, 107, 103, 118, 112, 121, 132, 110, 72, 113, 68, 120, 70, 76, 113, 101, 67, 110, 92, 82, 49, 79, 128, 113, 86, 84, 73, 49, 105, 137, 74, 176, 98, 40, 96, 54, 143, 33, 112, 363, 100, 101, 55, 122, 45, 105, 65, 106, 109, 69, 80, 122, 66, 67, 113, 115, 117, 40, 156, 109, 124, 100, 114, 99, 65, 81, 95, 60, 290, 71, 67, 85, 105, 86, 143, 71, 94, 88, 123, 97, 100, 109, 90, 127, 93, 78, 40, 89, 115, 122, 52, 91, 160, 166, 81, 85, 92, 92, 58, 88, 46, 137, 72, 73, 56, 99, 62, 70, 69, 74, 81, 131, 99, 81, 71, 53, 110, 113, 84, 90, 103, 80, 81, 88, 76, 102, 100, 90, 120, 96, 49, 95, 123, 61, 79, 56, 63, 55, 57, 25, 292, 106, 90, 105, 137, 127, 126, 69, 103, 125, 113, 60, 124, 82, 111, 87, 84, 105, 80, 122, 77, 106, 126, 105, 76, 227, 110, 116, 109, 98, 127, 127, 101, 137, 70, 76, 307, 129, 94, 101, 67, 70, 57, 87, 114, 97, 124, 83, 152, 73, 102, 81, 83, 76, 137, 74, 171, 143, 106, 123, 190, 106, 67, 329, 86, 5947, 88, 131, 162, 135, 236, 179, 140, 89, 93, 46, 129, 110, 152, 183, 81, 107, 71, 73, 73, 125, 376, 95, 96, 180, 114, 124, 115, 124, 155, 86, 140, 120, 98, 50, 54, 108, 36, 108, 136, 189, 49, 72, 90, 79, 141, 100, 112, 91, 119, 196, 275, 86, 339, 88, 65, 90, 133, 239, 164, 182, 125, 200, 51, 105, 118, 84, 115, 77, 134, 237, 118, 47, 100, 156, 151, 84, 107, 77, 91, 49, 81, 129, 86, 79, 111, 110, 51, 82, 84, 121, 68, 90, 81, 57, 70, 60, 72, 74, 92, 85, 65, 193, 177, 115, 85, 78, 72, 138, 76, 79, 136, 152, 89, 176, 106, 136, 164, 102, 142, 96, 107, 102, 107, 122, 79, 459, 42, 191, 220, 126, 93, 854, 258, 210, 218, 203, 105, 53, 98, 61, 58, 84, 270, 56, 118, 121, 117, 74, 101, 18, 185, 122, 26, 494, 191, 177, 81, 163, 103, 165, 195, 99, 160, 54, 262, 81, 105, 116, 305, 194, 118, 111, 85, 306, 194, 305, 155, 162, 136, 144, 64, 145, 119, 57, 87, 86, 67, 128, 114, 82, 105, 58, 102, 70, 99, 48, 188, 134, 151, 121, 107, 103, 117, 194, 134, 121, 115, 22, 190, 135, 205, 87, 160, 114, 83, 100, 75, 169, 95, 43, 229, 34, 90, 45, 121, 325, 131, 77, 374, 377, 107, 110, 172, 119, 375, 88, 235, 67, 328, 76, 101, 69, 149, 71, 87, 75, 153, 69, 102, 123, 89, 151, 129, 89, 99, 62, 125, 296, 62, 209, 169, 48, 129, 435, 58, 234, 323, 65, 344, 115, 106, 94, 84, 65, 71, 111, 75, 94, 45, 73, 66, 96, 66, 85, 24, 189, 103, 74, 51, 83, 93, 111, 92, 88, 89, 63, 71, 88, 108, 78, 95, 79, 106, 173, 93, 106, 90, 38, 101, 114, 76, 76, 121, 53, 63, 110, 80, 113, 92, 85, 116, 67, 79, 75, 106, 109, 51, 105, 118, 51, 101, 128, 101, 42, 99, 83, 75, 190, 54, 78, 122, 55, 330, 128, 121, 126, 159, 139, 121, 119, 182, 253, 341, 67, 116, 110, 93, 172, 69, 106, 89, 61, 197, 113, 139, 333, 32, 119, 123, 154, 79, 124, 167, 358, 268, 269, 246, 171, 170, 261, 181, 228, 89, 65, 137, 44, 147, 130, 123, 56, 117, 96, 78, 73, 196, 59, 127, 33, 107, 110, 135, 120, 175, 110, 103, 103, 88, 104, 104, 91, 134, 104, 98, 74, 89, 56, 112, 37, 87, 128, 53, 134, 91, 52, 76, 125, 116, 66, 99, 113, 14, 107, 91, 146, 118, 86, 210, 64, 102, 86, 69, 179, 171, 68, 57, 72, 65, 129, 51, 199, 97, 62, 52, 57, 53, 53, 50, 100, 60, 168, 157, 258, 24, 97, 74, 166, 48, 87, 35, 125, 40, 74, 82, 73, 244, 123, 69, 142, 78, 52, 100, 121, 239, 181, 147, 91, 100, 91, 314, 137, 89, 81, 123, 91, 112, 92, 51, 125, 70, 91, 97, 102, 104, 70, 114, 111, 78, 97, 105, 52, 112, 75, 77, 124, 316, 124, 126, 260, 106, 62, 107, 22, 182, 108, 30, 189, 38, 144, 119, 184, 2713, 126, 68, 83, 120, 110, 130, 122, 137, 51, 863, 106, 122, 222, 38, 29, 213, 105, 80, 92, 533, 283, 103, 88, 51, 89, 58, 82, 31, 484, 120, 148, 70, 141, 74, 146, 80, 119, 575, 48, 271, 86, 128, 88, 144, 6, 208, 86, 113, 296, 119, 312, 92, 525, 88, 29, 247, 46, 341, 103, 337, 125, 135, 469, 109, 334, 172, 480, 1092, 210, 139, 82, 405, 79, 83, 134, 100, 177, 243, 29, 243, 170, 210, 181, 138, 467, 47, 106, 63, 162, 66, 119, 69, 134, 322, 197, 107, 117, 121, 102, 65, 247, 67, 128, 125, 132, 79, 322, 57, 67, 198, 83, 98, 70, 13, 141, 177, 120, 108, 107, 93, 14, 238, 49, 205, 270, 110, 113, 154, 742, 89, 30, 120, 909, 78, 52, 113, 43, 175, 30, 137, 70, 82, 110, 157, 716, 168, 178, 138, 4, 356, 320, 422, 429, 269, 56, 152, 54, 20, 302, 169, 99, 998, 151, 1255, 355, 81, 466, 144, 275, 75, 112, 312, 274, 270, 161, 65, 77, 75, 23, 161, 129, 64, 43, 105, 157, 123, 368, 4, 300, 280, 205, 144, 282, 109, 55, 151, 273, 27, 155, 74, 84, 73, 73, 115, 130, 146, 118, 224, 283, 30, 201, 43, 274, 143, 1043, 81, 154, 203, 346, 276, 153, 635, 217, 182, 307, 43, 364, 120, 113, 48, 98, 4, 279, 129, 623, 122, 114, 105, 59, 123, 99, 76, 100, 8, 480, 80, 46, 90, 96, 224, 29, 627, 73, 272, 130, 147, 61, 8, 160, 79, 299, 102, 212, 90, 178, 34, 108, 445, 8, 134, 122, 118, 258, 135, 71, 108, 118, 262, 2286, 19, 213, 153, 34, 143, 83, 232, 317, 138, 98, 136, 4, 228, 183, 84, 626, 172, 431, 178, 2, 282, 204, 4, 189, 153, 6, 158, 83, 107, 52, 14, 219, 533, 143, 228, 105, 99, 194, 23, 314, 156, 56, 205, 165, 54, 210, 94, 113, 103, 163, 106, 21, 275, 156, 17, 159, 131, 74, 53, 76, 76, 383, 89, 121, 58, 156, 43, 146, 89, 100, 84, 46, 59, 123, 205, 160, 129, 205, 35, 34, 144, 64, 253, 81, 28, 151, 124, 114, 289, 178, 79, 196, 115, 27, 239, 65, 120, 111, 132, 472, 443, 174, 143, 265, 63, 344, 305, 84, 512, 253, 159, 95, 243, 85, 152, 260, 271, 94, 102, 157, 273, 446, 83, 64, 14, 416, 452, 34, 0, 741, 452, 299, 126, 39, 1118, 155, 37, 194, 330, 104, 110, 212, 104, 99, 134, 77, 565, 146, 371, 35, 187, 101, 85, 147, 110, 138, 143, 8, 301, 256, 870, 52, 123, 115, 101, 50, 95, 113, 18, 227, 398, 410, 110, 125, 173, 365, 4, 149, 176, 86, 85, 224, 14, 182, 110, 95, 61, 105, 51, 313, 99, 288, 254, 263, 27, 272, 67, 321, 10, 248, 65, 147, 133, 147, 8, 378, 175, 60, 100, 646, 22, 220, 64, 212, 75, 197, 113, 298, 201, 357, 317, 179, 81, 101, 182, 363, 2, 134, 257, 81, 127, 339, 65, 305, 294, 4, 300, 261, 108, 249, 123, 126, 113, 4, 285, 32, 278, 112, 20, 587, 586, 173, 392, 129, 19, 427, 132, 120, 529, 79, 19, 288, 276, 95, 128, 13, 91, 124, 158, 29, 191, 238, 106, 73, 93, 157, 23, 6, 116, 49, 71, 123, 167, 147, 111, 153, 56, 37, 151, 91, 227, 6, 596, 509, 82, 107, 95, 120, 177, 230, 4, 122, 391, 330, 6, 311, 200, 226, 106, 6, 142, 126, 146, 62, 122, 135, 74, 161, 118, 279, 188, 333, 8, 139, 6, 180, 199, 123, 42, 33, 389, 127, 494, 78, 810, 110, 6, 119, 53, 378, 232, 202, 82, 219, 79, 36, 120, 100, 6, 830, 539, 422, 8, 337, 462, 392, 180, 157, 6, 363, 67, 107, 188, 104, 56, 86, 97, 261, 357, 65, 10, 268, 1008, 192, 348, 45, 146, 146, 114, 328, 121, 71, 67, 367, 237, 680, 173, 237, 50, 168, 149, 108, 178, 191, 104, 123, 109, 104, 152, 307, 28, 325, 137, 57, 134, 41, 28, 169, 155, 176, 161, 115, 376, 288, 83, 184, 81, 382, 298, 162, 94, 29, 184, 89, 93, 302, 113, 298, 209, 109, 355, 275, 61, 173, 135, 258, 365, 111, 39, 161, 138, 39, 185, 292, 28, 520, 282, 56, 264, 103, 63, 42, 115, 153, 591, 253, 105, 111, 47, 148, 51, 509, 28, 170, 108, 32, 39, 64, 455, 29, 759, 305, 115, 31, 497, 6, 151, 68, 339, 63, 68, 142, 96, 36, 201, 292, 398, 126, 88, 51, 128, 546, 98, 290, 114, 146, 12, 198, 90, 58, 182, 50, 194, 34, 104, 105, 124, 86, 127, 39, 72, 159, 86, 40, 10, 137, 93, 108, 95, 41, 117, 31, 211, 93, 57, 821, 653, 310, 85, 292, 148, 101, 48, 246, 155, 90, 99, 114, 51, 117, 57, 78, 119, 462, 417, 213, 310, 175, 355, 400, 106, 168, 109, 135, 116, 291, 228, 44, 143, 14, 53, 100, 215, 33, 137, 204, 35, 139, 51, 191, 41, 93, 29, 125, 220, 117, 88, 131, 80, 110, 322, 387, 34, 27, 204, 97, 420, 1232, 45, 155, 334, 82, 63, 281, 6, 212, 183, 127, 243, 135, 82, 62, 48, 68, 153, 165, 135, 106, 40, 67, 73, 516, 569, 62, 7, 147, 81, 85, 266, 119, 262, 86, 7, 72, 547, 138, 174, 57, 157, 153, 175, 36, 292, 68, 178, 308, 4, 252, 184, 173, 151, 27, 157, 95, 60, 499, 92, 158, 159, 4, 153, 98, 113, 67, 473, 821, 32, 252, 129], "chunks": [{"heading": "Экосистема", "snippet": "Экосистема\nBitrix Framework — PHP-платформа для разработки веб-приложений. Она служит основой для двух продуктов: 1C-Битрикс: Управление сайтом и Битрикс24.\n\n1C-Битрикс: Управление сайтом — это система управления контентом (CMS). В ней созд", "page": "docs-about-ecosystem", "path": "/docs/about/ecosystem/", "title": "Экосистема"}, {"heading": "Как связаны CMS и Битрикс24", "snippet": "Как связаны CMS и Битрикс24\n1C-Битрикс: Управление сайтом и Битрикс24 входят в одну продуктовую экосистему. Bitrix Framework обеспечивает общую платформу для этих продуктов: подключает модули, предоставляет базовые сервисы и управляет взаим", "page": "docs-about-ecosystem", "path": "/docs/about/ecosystem/", "title": "Экосистема"}, {"heading": "Как устроен модульный монолит", "snippet": "Как устроен модульный монолит\nПродукты экосистемы работают как модульный монолит. Система состоит из самостоятельных модулей, но выполняется как единое приложение. Каждый модуль отвечает за отдельную область: контент, торговый каталог, CRM,", "page": "docs-about-ecosystem", "path": "/docs/about/ecosystem/", "title": "Экосистема"}, {"heading": "Что дальше", "snippet": "Что дальше\nЧтобы изучить связанные темы, перейдите к статьям:\n- [Архитектура](../framework/architecture.md),\n- [Жизненный цикл запроса](../framework/request-lifecycle.md),\n- [Роутинг](../framework/routing.md).\n\nЕсли нужно сравнить платформу", "page": "docs-about-ecosystem", "path": "/docs/about/ecosystem/", "title": "Экосистема"}, {"heading": "Отличия от других CMS", "snippet": "Отличия от других CMS\n1C-Битрикс: Управление сайтом — это система управления контентом (CMS) на основе Bitrix Framework. Как и другие CMS, например, WordPress и Joomla, она предоставляет инструменты для работы с контентом. Но каждая система", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "WordPress", "snippet": "WordPress\nВ WordPress основные единицы контента — запись (post) и страница. Записи обычно используются для блога, новостей или событий, а страницы — для статического контента, например, страниц *О компании* или *Контакты*.\n\nКаждая запись ил", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "WordPress", "snippet": "WordPress\nWordPress применяет класс `WP_Query` для выборки записей и страниц, а для прямых SQL-запросов — глобальный объект `$wpdb`. Данные хранятся в плоских таблицах, а связи организуются через таксономии или дополнительные плагины.\n\nJoom", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "WordPress", "snippet": "WordPress\nWordPress использует темы, которые состоят из PHP-шаблонов, CSS и JavaScript. В выделенные зоны темы можно добавлять виджеты, например, в сайдбар. Виджеты сочетают в себе как логику работы, так и отображение.\n\nШаблоны страниц испо", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "Joomla", "snippet": "Joomla\nДанные в Joomla состоят из статей и категорий. Дополнительные данные можно добавить через расширения. Связи между элементами поддерживаются через внешние плагины и компоненты.\n\nПоддержка расширений\n\n1C-Битрикс: Управление сайтом\nВ 1C", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "1C-Битрикс: Управление сайтом", "snippet": "1C-Битрикс: Управление сайтом\nСистема поддерживает расширение функционала через события, внедрение зависимостей и наследование классов. Разработчики могут создать собственные классы-наследники с измененной логикой в папке `/local/`.\n\nWordPr", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "Сравнительная таблица особенностей", "snippet": "Сравнительная таблица особенностей\n| Характеристика | 1C-Битрикс: Управление сайтом | WordPress | Joomla |\n|-----------------------|---------------------------------", "page": "docs-about-cms-comparison", "path": "/docs/about/cms-comparison/", "title": "Отличия от других CMS"}, {"heading": "Отличия от других фреймворков", "snippet": "Отличия от других фреймворков\nBitrix Framework часто ассоциируется с 1C-Битрикс: Управление сайтом, но ядро CMS — это полноценный PHP-фреймворк. Он включает модульную структуру, роутинг, MVC-элементы, систему событий и другие компоненты, ха", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Контроллеры", "snippet": "Контроллеры\nКонтроллер отвечает за обработку запроса и возврат ответа. В Bitrix Framework контроллеры можно реализовать двумя способами:\n\n- через наследование от класса `Bitrix\\Main\\Engine\\Controller` ,\n\n- через PHP-скрипты в папке `compo", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Роутинг", "snippet": "Роутинг\nРоутинг определяет, какой код выполнить при обращении к URL. В Bitrix Framework настройка маршрутов осуществляется через файл `routing_index.php`, в котором указывают путь, контроллер и действие. Подход похож на конфигурацию в Yii, ", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Middlewares или ActionFilter в Bitrix", "snippet": "Middlewares или ActionFilter в Bitrix\nMiddleware — это слой между запросом и контроллером. Он проверяет доступ, логирует и модифицирует данные. В Bitrix Framework используются классы на основе `\\Bitrix\\Main\\Engine\\ActionFilter`, которые при", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Задачи по расписанию", "snippet": "Задачи по расписанию\nЗадачи по расписанию выполняют фоновые операции в заданное время. В Bitrix Framework для этого используют агенты — PHP-функции, которые регистрируются в системе через `CAgent::AddAgent()`. Агенты вызываются на хитах при", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Очереди", "snippet": "Очереди\nОчереди позволяют откладывать выполнение задач. В Bitrix используется класс `\\Bitrix\\Main\\Messenger`. Это похоже на `yii\\queue` в Yii и `symfony/messenger` в Symfony. Laravel использует `queue:work` и Horizon для управления задачами", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "События и обработчики", "snippet": "События и обработчики\nСобытия позволяют одному участку кода реагировать на действия другого.\\\nВ Bitrix Framework события создают через `\\Bitrix\\Main\\EventManager` с регистрацией обработчиков по коду события. Это аналогично `Event::listen()`", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "CLI инструменты", "snippet": "CLI инструменты\nКомандная строка нужна для запуска задач, миграций, тестов. CLI упрощает автоматизацию и разработку.\n\nBitrix Framework поддерживает CLI через `bitrix.php` и пакет `@bitrix/cli`. Создавать команды можно так же, как в Laravel ", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Работа с Email", "snippet": "Работа с Email\nОтправка email — стандартная задача в веб-приложениях. В Bitrix она реализована через `\\Bitrix\\Main\\Mail\\Event` с использованием шаблонов из административной панели.\n\nВ Laravel, Symfony и Yii письма формируют в коде, использу", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Работа с SMS и мессенджерами", "snippet": "Работа с SMS и мессенджерами\nИнтеграция с SMS-шлюзами и мессенджерами требует подключения внешних сервисов.\n\nВ Bitrix Framework добавить интеграции можно через [REST API](https://apidocs.bitrix24.ru/) или с помощью модулей из [Marketplace](", "page": "docs-about-framework-comparison", "path": "/docs/about/framework-comparison/", "title": "Отличия от других фреймворков"}, {"heading": "Как правильно и безопасно кастомизировать коробочные продукты", "snippet": "Как правильно и безопасно кастомизировать коробочные продукты\nОшибки в кастомизации приводят к потере данных, нарушают стабильную работу системы, создают уязвимости в безопасности и сложности в установке обновлений. Это критично, потому что", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "Пройдите обучение", "snippet": "Пройдите обучение\nПройдите курсы по разработке на платформе Bitrix Framework, чтобы лучше понимать возможности платформы и избежать ошибок. Если разработкой занимается сторонний специалист, убедитесь, что у него есть сертификат о прохождени", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "Где размещать изменения", "snippet": "Где размещать изменения\nИзменения рекомендуем хранить в папке `/local/`. Это обеспечит четкое разделение между системными файлами и кастомизацией. Папка `/local/` не перезаписывается при обновлениях системы, поэтому ваши доработки останутся", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "Что не рекомендуется делать", "snippet": "Что не рекомендуется делать\n1. **Не пишите прямые SQL-запросы к базе данных.** Используйте документированное API продукта. Прямые SQL-запросы обходят встроенные механизмы безопасности и валидации. Это может привести к уязвимости системы и н", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "Инструменты кастомизации", "snippet": "Инструменты кастомизации\nПродукт предоставляет инструменты для кастомизации под любые задачи: от no-code решений до работы с API и кодом Bitrix Framework. Выберите подходящий инструмент в зависимости от ваших целей и уровня сложности проект", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "REST API", "snippet": "REST API\nБитрикс24 предлагает разработчикам инструменты для создания интеграций, автоматизации рабочих процессов и кастомизации пользовательских сценариев через REST API.\n\n[Документация REST API](https://apidocs.bitrix24.ru/)\n\nОбработчики с", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "CSS и JS кастомизация", "snippet": "CSS и JS кастомизация\nИспользуйте CSS и JavaScript для изменения внешнего вида и поведения сайта. Подключайте стили и скрипты через [Bitrix\\Main\\Page\\Asset](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Page-Asset.html), чтобы избежать ", "page": "docs-get-started-how-customize", "path": "/docs/get-started/how-customize/", "title": "Как правильно и безопасно кастомизировать коробочные продукты"}, {"heading": "Установка окружения", "snippet": "Установка окружения\nПеред началом работы с продуктами 1С-Битрикс необходимо настроить рабочее окружение. Компания 1С-Битрикс предлагает готовое окружение в нескольких вариантах:\n\n- BitrixVM — виртуальный образ для быстрого старта.\n\n- Bitr", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Окружение BitrixEnv для выделенного сервера", "snippet": "Окружение BitrixEnv для выделенного сервера\nЕсли у вас есть выделенный сервер, вы можете установить необходимые пакеты и настроить окружение с помощью скрипта `bitrix-env-9.sh`\n\nПоддерживаются операционные системы:\n\n- CentOS Stream 9\n\n- R", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Установка на CentOS Stream 9", "snippet": "Установка на CentOS Stream 9\nРассмотрим установку окружения на примере операционной системы CentOS Stream 9. Установка на другие операционные системы выполняется аналогично, с учетом особенностей операционной системы.\n\n1. Войдите под пользо", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Тихая установка", "snippet": "Тихая установка\nУстановить BitrixEnv можно в тихом режиме, то есть без участия пользователя. Укажите параметры в команде запуска скрипта, чтобы автоматически создать пул, включить Push-сервер и задать пароль для пользователя `root` MySQL.\n", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "установить Percona 8.4 и задать пароль root для MySQL", "snippet": "установить Percona 8.4 и задать пароль root для MySQL\n```\n\n!!! warning \"Внимание\"\n\n\n Запуск push сервера `-P` при установке окружения сработает только в связке с созданием пула `-p`.\n\nAmazon Elastic Compute Cloud\nAmazon Elastic Compute C", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Обязательные настройки окружения", "snippet": "Обязательные настройки окружения\n1. Создайте пул сервера *1\\. Create Management pool of server*. После создания пула пункт заменится на *1\\. Manage servers in the pool* и станет доступно полное меню. Откроются порты для работы продуктов:\n\n ", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Docker-образы", "snippet": "Docker-образы\nКонтейнерное окружение для Битрикс — решение на базе технологий [Docker](https://www.docker.com/), которое позволяет быстро настроить среду для тестирования и разработки. Официальный репозиторий и подробная документация по про", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Кастомная настройка", "snippet": "Кастомная настройка\nНастроить окружение можно самостоятельно на основе CentOS Stream 9 или других операционных систем.\n\n!!! tip \"Совет\"\n\n\n Подробнее в статье [Установка 1С-Битрикс: Управление сайтом и коробочной версии Битрикс24 на други", "page": "docs-get-started-install-env", "path": "/docs/get-started/install-env/", "title": "Установка окружения"}, {"heading": "Установка дистрибутива", "snippet": "Установка дистрибутива\nПосле подготовки окружения можно установить дистрибутив двумя способами.\n\n1. **Использовать скрипт bitrixsetup.php.** Скрипт скачивает и распаковывает дистрибутив на сервере.\n\n2. **Cкачать архив с официального сайта.*", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Скрипт bitrixsetup.php", "snippet": "Скрипт bitrixsetup.php\n1. Скачайте скрипт `bitrixsetup.php` в корневую папку сайта.\n\n!!! note \"Примечание\"\n\n\n В BitrixVM корневая папка дефолтного сайта находится по пути `/home/bitrix/www/`. Если сайтов несколько — у каждого будет св", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Архив с сайта", "snippet": "Архив с сайта\nСкачать дистрибутив можно с официального сайта:\n\n- [1С-Битрикс: Управление сайтом](https://www.1c-bitrix.ru/download/cms.php#tab-subsection-3)\n\n- [Коробочная версия Битрикс24](https://www.1c-bitrix.ru/download/intranet.php)\n", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Регистрация продукта", "snippet": "Регистрация продукта\n![](./_images/install-distr-2.png){width=733px height=291px}\n\n**Лицензионный ключ.** Введите лицензионный ключ. Если вы хотите установить демоверсию, отметьте опцию *Я хочу зарегистрировать копию и получать обновления* ", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Проверка системы", "snippet": "Проверка системы\n!!! note \"Примечание\"\n\n\n Мастер пропускает шаг для BitrixVM.\n\n\n\nМастер проверяет настройки окружения для успешной работы продукта.\n\nРезультаты проверки отображаются цветами:\n\n- зеленый — значения удовлетворяют требовани", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Параметры базы данных", "snippet": "Параметры базы данных\n!!! note \"Примечание\"\n\n\n Мастер пропускает шаг для BitrixVM.\n\n\n\nПродукты поддерживают базы данных MySQL и PostgreSQL.\n\nЗаполните параметры базы данных.\n\n![](./_images/install-distr-4.png){width=600px height=379px}\n\n", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Установка продукта", "snippet": "Установка продукта\nМастер устанавливает продукт: создает таблицы в базе данных и копирует файлы системы.\n\n![](./_images/install-distr.png){width=600px height=163px}\n\nПараметры администратора\nЗаполните поля, чтобы создать учетную запись адми", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Быстрая установка", "snippet": "Быстрая установка\nБыстрая установка пропускает первые шаги мастера и начинает установку продукта. Чтобы запустить быструю установку создайте файл `.settings.php` с настройками в папке `/bitrix/` дистрибутива.\n\nПример файла `/bitrix/.setting", "page": "docs-get-started-install-distr", "path": "/docs/get-started/install-distr/", "title": "Установка дистрибутива"}, {"heading": "Установка решения", "snippet": "Установка решения\nРешение — это функциональный пакет, который расширяет возможности системы. Оно содержит модули для новых функций, шаблоны дизайна, компоненты и демоданные для быстрого старта. С его помощью можно быстро развернуть интернет", "page": "docs-get-started-install-solution", "path": "/docs/get-started/install-solution/", "title": "Установка решения"}, {"heading": "Установка готового решения", "snippet": "Установка готового решения\n![](./_images/install-solution.png){width=740px height=623px}\n\n1. Выберите подходящий вариант для установки:\n\n - Корпоративный сайт производственной компании — пример сайта мебельного производства,\n\n - Корпо", "page": "docs-get-started-install-solution", "path": "/docs/get-started/install-solution/", "title": "Установка решения"}, {"heading": "Особенности установки решений", "snippet": "Особенности установки решений\n- Решения от партнеров не поддерживаются техподдержкой компании 1С-Битрикс.\n\n- В продукт встроена защита от переустановки решения с целью получить бесконечную пробную версию. Удаление модуля через файловую си", "page": "docs-get-started-install-solution", "path": "/docs/get-started/install-solution/", "title": "Установка решения"}, {"heading": "Активация лицензии {#activation}", "snippet": "Активация лицензии {#activation}\nЛицензионный ключ подтверждает право на использование продукта. Активируйте ключ перед использованием коммерческой версии.\n\n!!! warning \"Внимание\"\n\n\n Один лицензионный ключ работает для двух установок. Од", "page": "docs-get-started-install-solution", "path": "/docs/get-started/install-solution/", "title": "Установка решения"}, {"heading": "Структура директорий", "snippet": "Структура директорий\nПроекты на Bitrix Framework имеют четкую структуру директорий, которая разделяет системные файлы, пользовательские разработки и загружаемый контент. Это позволяет:\n\n- не изменять ядро при правках сайта,\n\n- обновлять с", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Основные системные каталоги и файлы", "snippet": "Основные системные каталоги и файлы\n- `/activities/` — действия для бизнес-процессов.\n\n- `/admin/` — административные скрипты.\n\n- `/components/` — системные и пользовательские компоненты.\n\n- `/css/` — общие стили модулей.\n\n- `/gadgets/", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Кеш", "snippet": "Кеш\n- `/cache/` — кешированные данные.\n\n- `/stack_cache/` — кеш с вытеснением.\n\n- `/managed_cache/` — управляемый кеш.\n\nДизайн и шаблоны\n- `/templates/` — шаблоны сайтов и компонентов:\n\n - `/.default/` — файлы шаблона по умолчанию.\n\n", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Что можно хранить", "snippet": "Что можно хранить\n- `/activities/` — действия бизнес-процессов.\n\n- `/components/` — компоненты.\n\n- `/gadgets/` — гаджеты рабочего стола.\n\n- `/modules/` — пользовательские модули.\n\n- `/php_interface/` — файл инициализации `init.php` и я", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Как перенести проект", "snippet": "Как перенести проект\n1. Создайте аналогичную структуру папок в `/local/`.\n\n2. Постепенно переносите измененные файлы из `/bitrix/` и проверяйте работу сайта.\n\n3. Используйте *Монитор качества*, чтобы выявить измененные файлы ядра. Найти его", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Как работать с файлами", "snippet": "Как работать с файлами\nВсе операции с файлами рекомендуется выполнять через стандартные инструменты:\n\n- медиабиблиотеку — для изображений, аудио, видео и документов,\n\n- файловый менеджер — для работы с файлами в административном разделе,\n", "page": "docs-get-started-directory-structure", "path": "/docs/get-started/directory-structure/", "title": "Структура директорий"}, {"heading": "Composer", "snippet": "Composer\nComposer — стандартный менеджер зависимостей для PHP, который позволяет управлять библиотеками и их версиями. В Bitrix Framework он открывает доступ к современным инструментам разработки:\n\n- ORM-аннотациям,\n\n- интерфейсу командно", "page": "docs-get-started-composer", "path": "/docs/get-started/composer/", "title": "Composer"}, {"heading": "Где разместить composer.json", "snippet": "Где разместить composer.json\nПо умолчанию система ищет файл `composer.json` в папке `/home/bitrix/www/bitrix/`. Рекомендуется размещать `composer.json` за пределами `DOCUMENT_ROOT`, например, в `/home/bitrix/`. Это предотвратит публичный до", "page": "docs-get-started-composer", "path": "/docs/get-started/composer/", "title": "Composer"}, {"heading": "Как подключить стандартные зависимости", "snippet": "Как подключить стандартные зависимости\nПодключите файл со стандартными зависимостями Bitrix Framework `composer-bx.json`.\n\n1. Установите плагин [Composer Merge Plugin](https://github.com/wikimedia/composer-merge-plugin).\n\n2. В файл `compose", "page": "docs-get-started-composer", "path": "/docs/get-started/composer/", "title": "Composer"}, {"heading": "Создание страницы", "snippet": "Создание страницы\nВ Bitrix Framework страницы можно создавать двумя способами.\n\n- Через файловую систему — для кастомных страниц и разработки.\n\n- С помощью интерфейса системы — чтобы быстро создать контент.\n\nКак создать страницу вручную\n1", "page": "docs-get-started-create-page", "path": "/docs/get-started/create-page/", "title": "Создание страницы"}, {"heading": "Как создать страницу через интерфейс", "snippet": "Как создать страницу через интерфейс\nСтраницу можно создать c помощью инструментов публичного и административного разделов сайта.\n\nПубличный раздел\nВ публичном разделе сайта можно создать страницу с помощью мастера. Для этого перейдите в ну", "page": "docs-get-started-create-page", "path": "/docs/get-started/create-page/", "title": "Создание страницы"}, {"heading": "Мастер создания страницы", "snippet": "Мастер создания страницы\n1. Заполните основные параметры.\n\n - Заголовок страницы — отображается пользователям на странице сайта,\n\n - Имя файла — название файла в файловой структуре сайта. По умолчанию формируется из заголовка.\n\n Отм", "page": "docs-get-started-create-page", "path": "/docs/get-started/create-page/", "title": "Создание страницы"}, {"heading": "Страницы по шаблону", "snippet": "Страницы по шаблону\nДля однотипных страниц используйте шаблоны. Шаблоны должны быть созданы заранее.\n\n1. На административной панели нажмите *Создать страницу > По шаблону*.\n\n2. Выберите шаблон.\n\n3. Пройдите шаги мастера.\n\nСтраница будет соз", "page": "docs-get-started-create-page", "path": "/docs/get-started/create-page/", "title": "Создание страницы"}, {"heading": "Создание компонента", "snippet": "Создание компонента\nС помощью Bitrix Framework можно создавать свои компоненты, чтобы расширить возможности проекта. В статье описан процесс создания на примере компонента *Карточка пользователя*.\n\n1. Компонент будет отображать имя, аватар ", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Структура компонента", "snippet": "Структура компонента\nСоздайте следующие папки и файлы для компонента:\n\n```\n/local/components/my/user.card/\n├── .description.php // Описание компонента\n├── .parameters.php // Параметры компонента\n├── class.php //", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Файл .description.php", "snippet": "Файл .description.php\nФайл `.description.php` содержит массив `$arComponentDescription` с основными характеристиками компонента. В массив передайте название компонента, описание и расположение в дереве компонентов.\n\n```php\n {\n document.querySelectorAll", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Архив с примером компонента", "snippet": "Архив с примером компонента\nВсе файлы компонента `user.card` можно [скачать в архиве](https://dev.1c-bitrix.ru/docs/chm_files/user.card.zip). Для работы распакуйте архив в папку `/local/components/my/`.\n\n![](./_images/create-component.png){", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Как добавить компонент на страницу", "snippet": "Как добавить компонент на страницу\nСначала создайте страницу, например, `/my-page/index.php`. Подробности читайте в статье [Создание страницы](./create-page.md).\n\nРазместите на странице и настройте новый компонент.\n\n1. Откройте страницу `/m", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Исходный код страницы", "snippet": "Исходный код страницы\nСтраница `/my-page/index.php` с размещенным на ней компонентом имеет следующий код:\n\n```php\nSetTitle('');\n\n$APPLICATION->IncludeComponent(\n", "page": "docs-get-started-create-component", "path": "/docs/get-started/create-component/", "title": "Создание компонента"}, {"heading": "Создание модуля", "snippet": "Создание модуля\nBitrix Framework состоит из модулей. Каждый модуль отвечает за отдельную область системы: управление контентом, email-рассылки, рекламу или пользовательскую функциональность проекта.\n\nЧто такое модуль\nМодуль — это автономный", "page": "docs-get-started-create-module", "path": "/docs/get-started/create-module/", "title": "Создание модуля"}, {"heading": "Пользовательские модули", "snippet": "Пользовательские модули\nРазработчики могут создавать свои модули в Bitrix Framework. Пользовательские модули размещают в папке `/local/modules/`. Это обеспечивает четкое разделение между системными файлами и кастомизацией. Папка `/local/` н", "page": "docs-get-started-create-module", "path": "/docs/get-started/create-module/", "title": "Создание модуля"}, {"heading": "Партнерские модули", "snippet": "Партнерские модули\nПартнерский модуль — это модуль, который разрабатывают партнеры 1С-Битрикс и размещают на [Маркетплейсе](https://marketplace.1c-bitrix.ru/) после модерации. Любой клиент 1С-Битрикс может установить такой модуль в свой про", "page": "docs-get-started-create-module", "path": "/docs/get-started/create-module/", "title": "Создание модуля"}, {"heading": "Структура модуля", "snippet": "Структура модуля\n1. Создайте папку `my.module` в `/local/modules/`.\n\n2. Добавьте папки и файлы с описанием, версией, языковыми файлами и конфигурацией модуля в `/local/modules/my.module/`.\n\n3. В папке `/local/modules/my.module/install/compo", "page": "docs-get-started-create-module", "path": "/docs/get-started/create-module/", "title": "Создание модуля"}, {"heading": "Основной файл установки", "snippet": "Основной файл установки\nФайл `/install/index.php` описывает класс модуля. Класс `my_module` состоит из следующих частей:\n\n- конструктора — загружает файл `version.php`, название и описание модуля,\n\n- методов установки и удаления: `DoInsta", "page": "docs-get-started-create-module", "path": "/docs/get-started/create-module/", "title": "Создание модуля"}, {"heading": "Файл результата установки", "snippet": "Файл результата установки\nФайл `/install/step.php` выводит сообщение после установки модуля. Его подключает метод `DoInstall()` через `$APPLICATION->IncludeAdminFile()`.\n\n```php\n {\n // Обработка клика на аватар\n document.querySelectorAll('.js-my-user-", "page": "docs-get-started-create-controller", "path": "/docs/get-started/create-controller/", "title": "Создание контроллера"}, {"heading": "Стили style.css", "snippet": "Стили style.css\nВ файл `/install/components/my/user.card/templates/.default/style.css` добавьте стили для текста лайка .\n\n```css\n.my-user-card {\n background: #cff9f2;\n padding: 15px;\n width: 230px;\n}\n\n.my-user-card__avatar {\n ma", "page": "docs-get-started-create-controller", "path": "/docs/get-started/create-controller/", "title": "Создание контроллера"}, {"heading": "Класс компонента class.php", "snippet": "Класс компонента class.php\nВнесите изменения в основной класс компонента `/install/components/my/user.card/class.php`:\n\n- подключите `ServiceLocator` и `LikeService`,\n\n- в выборку пользователя добавьте поле `ID`,\n\n- в `arResult` добавьте", "page": "docs-get-started-create-controller", "path": "/docs/get-started/create-controller/", "title": "Создание контроллера"}, {"heading": "Настройка .settings.php", "snippet": "Настройка .settings.php\nФайл `/local/modules/my.module/.settings.php` обязателен для работы контроллеров. Добавьте регистрацию контроллера. В результате становится возможен вызов `my:module.user.like`.\n\n- `defaultNamespace` должен соответс", "page": "docs-get-started-create-controller", "path": "/docs/get-started/create-controller/", "title": "Создание контроллера"}, {"heading": "Как разместить компонент на сайте", "snippet": "Как разместить компонент на сайте\n1. В административном разделе откройте страницу *Marketplace > Установленные решения*.\n\n2. Установите модуль *Мой модуль (my.module)*.\n\n3. Создайте страницу и разместите на ней компонент *Карточка пользоват", "page": "docs-get-started-create-controller", "path": "/docs/get-started/create-controller/", "title": "Создание контроллера"}, {"heading": "Что дальше", "snippet": "Что дальше\nПосле освоения базовых шагов можно перейти к основным аспектам разработки на Bitrix Framework. Следующие разделы документации помогут глубже понять систему.\n\nОсновы фреймворка\nРаздел раскрывает архитектурные принципы работы Bitri", "page": "docs-get-started-next-steps", "path": "/docs/get-started/next-steps/", "title": "Что дальше"}, {"heading": "Производительность", "snippet": "Производительность\nРаздел включает техники оптимизации работы приложений. Описываются способы кеширования, оптимизации запросов и масштабирования нагрузки.\n\n[Производительность](./../performance/caching.md)", "page": "docs-get-started-next-steps", "path": "/docs/get-started/next-steps/", "title": "Что дальше"}, {"heading": "Конфигурация ядра", "snippet": "Конфигурация ядра\nКритически важные настройки ядра хранятся в файле конфигурации. Это защищает их от случайного изменения через административный раздел и повышает безопасность.\n\nОсновной файл конфигурации — `/bitrix/.settings.php`. Менять н", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Папка для разработки", "snippet": "Папка для разработки\nНачиная с версии Главного модуля 24.100.0 конфигурационные файлы можно хранить в папке `/local/`:\n\n- `.settings.php` и `.settings_extra.php` — в корне `/local/`,\n\n- `dbconn.php` — в папке `/local/php_interface/`.\n\nПо", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Параметры соединения с базой данных", "snippet": "Параметры соединения с базой данных\nСекция `connections` хранит параметры для подключения к основному и дополнительным источникам данных. Здесь указываются хосты, логины, пароли и имена баз данных.\n\n```php\n'connections' => [\n 'value' => ", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Обработка ошибок", "snippet": "Обработка ошибок\nСекция `exception_handling` управляет реакцией приложения на ошибки и исключения. Она задает правила вывода на экран, логирования и определения критичных ошибок.\n\n```php\n'exception_handling' => [\n 'value' => [\n 'd", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Маски типов ошибок", "snippet": "Маски типов ошибок\nПараметры `handled_errors_types` и `exception_errors_types` используют битовые маски. Битовая маска — это число, где каждый бит отвечает за включение или выключение конкретного типа ошибки. Например, `E_ALL & ~E_NOTICE` о", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Настройка логирования", "snippet": "Настройка логирования\nЧтобы логировать ошибки в файл с ограничением размера, используйте конфигурацию `log`.\n\n```php\n'log' => [\n 'settings' => [\n 'file' => 'bitrix/modules/error.log', // Путь к файлу лога относительно корня сайта\n", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Кеширование", "snippet": "Кеширование\nВ секции `cache`:\n\n- указываются механизм кеширования,\n\n- настраиваются параметры: тип кеша, время жизни и другие.\n\nПример настройки для `Redis`:\n\n```php\n'cache' => [\n 'value' => [\n 'type' => [ // Настройки типа кеши", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Push & Pull сервер", "snippet": "Push & Pull сервер\nСекция конфигурирует сервер очередей сообщений для работы чатов и уведомлений в реальном времени. Для стандартных проектов рекомендуется настраивать Push & Pull сервер в административном разделе. Секция в конфигурационном", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "HTTP-клиент", "snippet": "HTTP-клиент\nСекция `http_client_options` задает параметры по умолчанию для класса `Bitrix\\Main\\Web\\HttpClient`: таймауты, прокси, редиректы.\n\nС версии Главного модуля 23.0.0 `HttpClient` поддерживает стандарт PSR-18, а также работает в режи", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Регистрация сервисов", "snippet": "Регистрация сервисов\nСекция `services` регистрирует пользовательские сервисы в контейнере зависимостей. Это позволяет централизованно управлять зависимостями приложения.\n\nПодробнее в статье [Сервис Локатор](./service-locator#%D0%BA%D0%BE%D0", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Роутинг", "snippet": "Роутинг\nСекция `routing` определяет, какие файлы конфигурации маршрутов подключать из `/bitrix/routes/` и `/local/routes/`.\n\n```php\n'routing' => [\n 'value' => [\n 'config' => ['web.php'], // Можно добавить другие файлы: 'api.php', ", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Шифрование", "snippet": "Шифрование\nСекция `crypto` хранит ключ для шифрования конфиденциальных данных. Всегда используйте уникальный ключ.\n\n```php\n'crypto' => [\n 'value' => [\n 'crypto_key' => 'mysupersecretphrase', // Рекомендуется использовать 32-символ", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Включение локальных SMTP-подключений", "snippet": "Включение локальных SMTP-подключений\nДобавьте секцию `smtp` в файл `/bitrix/.settings.php`, прежде чем создавать SMTP-подключения в административном интерфейсе. Параметр `enabled` обязателен: без него система не использует созданные подключ", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Настройка SMTP-сервера по умолчанию", "snippet": "Настройка SMTP-сервера по умолчанию\nЧтобы отправлять письма через один SMTP-сервер по умолчанию, укажите параметры подключения в секции `smtp`:\n\n```php\n'smtp' => [\n 'value' => [\n 'enabled' => true, // Включить отправку через SMTP\n", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Очереди сообщений", "snippet": "Очереди сообщений\nСекция `messenger` содержит конфигурацию очередей.\n\n```php\n'messenger' => [\n 'value' => [\n 'run_mode' => 'web', // Режим обработки сообщений: web или cli\n 'brokers' => [\n 'default' => [\n ", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Язык по умолчанию", "snippet": "Язык по умолчанию\nСекция `default_language` задает язык по умолчанию. Система будет использовать его, если перевод для текущего языка недоступен. Это гарантирует, что интерфейс никогда не будет пустым.\n\n```php\n'default_language' => [\n 'v", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Получить настройки секции", "snippet": "Получить настройки секции\nСтатический метод `getValue($name)` возвращает значение указанной секции настроек.\n\n- `$name` — название секции, например, `'cache'`.\n\n```php\n// Получить настройки кеширования\n$cacheConfig = \\Bitrix\\Main\\Config\\Co", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Добавить или изменить параметры секции", "snippet": "Добавить или изменить параметры секции\n`add($name, $value)` — добавляет или меняет параметры секции.\n\n- `$name` — название секции,\n\n- `$value` — массив с настройками.\n\n```php\n// Получить объект конфигурации\n$config = \\Bitrix\\Main\\Config\\C", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Сохранить настройки", "snippet": "Сохранить настройки\nМетод `saveConfiguration()` сохраняет все изменения из `add()` и `addReadonly()`.\n\n```php\n// Получить объект конфигурации\n$config = \\Bitrix\\Main\\Config\\Configuration::getInstance();\n\n// Изменить настройку\n$config->add('e", "page": "docs-framework-settings", "path": "/docs/framework/settings/", "title": "Конфигурация ядра"}, {"heading": "Архитектура", "snippet": "Архитектура\nBitrix Framework состоит из независимых модулей, которые работают друг с другом как единое приложение. Такая архитектура называется модульным монолитом.\n\nОсновные принципы архитектуры\n**Преемственность**. Новые версии поддержива", "page": "docs-framework-architecture", "path": "/docs/framework/architecture/", "title": "Архитектура"}, {"heading": "Дополнительные элементы системы", "snippet": "Дополнительные элементы системы\n- Компоненты — виджеты с логикой на PHP и шаблонами.\n\n- Расширения — виджеты для фронтенда на JavaScript.\n\n- Агенты — задачи, которые выполняются по расписанию.\n\n- Префильтры и постфильтры — обработчики д", "page": "docs-framework-architecture", "path": "/docs/framework/architecture/", "title": "Архитектура"}, {"heading": "Контроллеры", "snippet": "Контроллеры\nЗапрос пользователя поступает на единую точку входа — роутер. Система сама определяет, какой контроллер его обработает.\n\nПорядок обработки запроса:\n\n1. **Роутинг**. Запрос попадает в файл `/bitrix/routing_index.php`. Он анализир", "page": "docs-framework-architecture", "path": "/docs/framework/architecture/", "title": "Архитектура"}, {"heading": "Физические страницы", "snippet": "Физические страницы\nЗапрос пользователя поступает на PHP-файл в структуре сайта, например, `/about/company.php`.\n\nПорядок обработки запроса:\n\n1. **Запуск страницы.** Сервер выполняет код файла `/about/company.php`.\n\n2. **Подключение заголов", "page": "docs-framework-architecture", "path": "/docs/framework/architecture/", "title": "Архитектура"}, {"heading": "Автозагрузка классов", "snippet": "Автозагрузка классов\nАвтозагрузка классов (autoloading) помогает системе автоматически находить и загружать необходимые классы. Это позволяет не подключать файлы вручную.\n\nПодключить модули\nМетод `includeModule()` подключает указанный модул", "page": "docs-framework-autoloading", "path": "/docs/framework/autoloading/", "title": "Автозагрузка классов"}, {"heading": "Зарегистрировать класс для автозагрузки", "snippet": "Зарегистрировать класс для автозагрузки\nРегистрируйте для автозагрузки классы, которые используются в большинстве сценариев, например, классы для работы с базой данных или обработки запросов. Это избавит систему от повторного поиска файлов.", "page": "docs-framework-autoloading", "path": "/docs/framework/autoloading/", "title": "Автозагрузка классов"}, {"heading": "Зарегистрировать пространство имен по PSR-4", "snippet": "Зарегистрировать пространство имен по PSR-4\nPSR-4 — стандарт автозагрузки:\n\n- где каждый `\\` в пространстве имен соответствует папке,\n\n- имя класса должно совпадать с именем файла.\n\nДобавляйте пространства имен для автозагрузки в файл `/l", "page": "docs-framework-autoloading", "path": "/docs/framework/autoloading/", "title": "Автозагрузка классов"}, {"heading": "Жизненный цикл запроса", "snippet": "Жизненный цикл запроса\nHTTP-запрос проходит путь от браузера до сервера и обратно.\n\nBitrix Framework участвует в этом процессе: он получает запрос, определяет, как его обработать, и запускает жизненный цикл страницы.\n\nПолучить запрос\nВеб-се", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "AJAX-контроллер", "snippet": "AJAX-контроллер\nКонтроллер обрабатывает запросы напрямую через PHP-файл. Маршрутизация не активируется, шапка и подвал сайта не подключаются. Это позволяет работать только с нужными данными в фоне и обновлять часть страницы без полной перез", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Запустить жизненный цикл страницы", "snippet": "Запустить жизненный цикл страницы\nПосле того как запрос направлен на конкретную страницу, начинается ее жизненный цикл. Страница в Bitrix Framework — это PHP-файл, который состоит из трех частей. Эти части помогают управлять подключениями, ", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Подготовить контекст", "snippet": "Подготовить контекст\nСлужебная часть пролога — файл `/bitrix/modules/main/include/prolog_before.php`\n\nНа этом этапе происходит подготовка к выполнению страницы. Система подключает необходимые для работы ядра файлы и устанавливает соединение", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Файл init.php", "snippet": "Файл init.php\nФайл `init.php` — необязательный файл ранней инициализации проекта. Используйте его только для небольшого кода, который должен подключиться в прологе, например для регистрации обработчиков событий. В проектах размещайте файл в", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Подключить шапку", "snippet": "Подключить шапку\nВизуальная часть пролога — файл `/bitrix/modules/main/include/prolog_after.php`\n\nНа этом этапе подключается визуальная часть страницы, которая включает в себя элементы интерфейса, такие как шапка сайта. Это важно для создан", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Сформировать контент", "snippet": "Сформировать контент\nВ этой части происходит основная работа с контентом, который отображается для пользователя. Это центральная часть страницы, где размещается HTML-код, PHP-скрипты и другие элементы, необходимые для отображения информаци", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Подключить подвал", "snippet": "Подключить подвал\nВизуальная часть эпилога — файл `/bitrix/modules/main/include/epilog_before.php`\n\nНа этом этапе подключаются элементы, которые завершают визуальное оформление страницы, такие как подвал сайта. Это помогает завершить структ", "page": "docs-framework-request-lifecycle", "path": "/docs/framework/request-lifecycle/", "title": "Жизненный цикл запроса"}, {"heading": "Роутинг", "snippet": "Роутинг\nРоутинг связывает URL-адреса с обработчиками — функциями или контроллерами. В Bitrix Framework он управляет маршрутизацией запросов, что позволяет создавать гибкие и масштабируемые приложения.\n\n!!! note \"Примечание\"\n\n\n Главный мо", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Конфигурация", "snippet": "Конфигурация\nЧтобы система начала обрабатывать маршруты, добавьте секцию `routing` в файл конфигурации [/bitrix/.settings.php](./settings).\n\n```php\n'routing' => [\n 'value' => [\n 'config' => ['web.php'], // Можно добавить другие фа", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Типы обработчиков маршрутов", "snippet": "Типы обработчиков маршрутов\nВ качестве обработчика маршрута можно использовать разные подходы.\n\n1. Замыкание — анонимная функция.\n\n ```php\n $routes->any('/blog', static fn() => 'my blog');\n ```\n\n2. Контроллер — класс, который обрабаты", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "HTTP-методы", "snippet": "HTTP-методы\nМетод `$routes->any()` означает, что любой HTTP-метод будет обрабатывать маршрут. При необходимости укажите конкретный метод.\n\n```php\n$routes->post('/blog/post/', [PostController::class, 'create']);\n$routes->get('/blog/post/{cod", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Параметры маршрута", "snippet": "Параметры маршрута\nПараметры маршрута — это динамические части URL, которые принимают различные значения. Заключайте параметры в фигурные скобки `{}`, например, `/blog/post/{code}`.\n\n```php\n$routes->get('/blog/post/{code}', static function(", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Паттерны для параметров", "snippet": "Паттерны для параметров\nПо умолчанию параметры используют паттерн `[^/]+`. Шаблон `/blog/post/{code}` преобразуется в строку с регулярным выражением `/blog/post/(?[^/]+)`.\n\nЕсли нужно свое регулярное выражение, укажите его методом `wh", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Именованные маршруты", "snippet": "Именованные маршруты\nПрисвоение имен маршрутам помогает организовать и систематизировать их. Имена выступают в роли уникальных идентификаторов. Их можно использовать для генерации ссылок и упрощения навигации.\n\nЧтобы задать имя маршруту, ис", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Группировка маршрутов", "snippet": "Группировка маршрутов\nГруппы маршрутов объединяют несколько маршрутов с общими характеристиками. Это помогает избежать дублирования кода. Общие настройки можно изменить в одном месте.\n\nВ случае с блогом у нас есть маршруты без группировки.\n", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Префикс группы", "snippet": "Префикс группы\nДля уменьшения шаблонов URL добавляйте префиксы методом `prefix`.\n\n```php\n$routes\n ->prefix('blog')\n ->group(static function(RoutingConfigurator $routes) {\n $routes->get('', [BlogController::class, 'index']); // ", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Параметры группы", "snippet": "Параметры группы\nВыносите однотипные параметры на уровень группы методом `where`.\n\n- Без группировки.\n\n```php\n$routes->post('/blog/post/', [PostController::class, 'create'])->where('code', '[\\w+\\d+\\-]');\n$routes->get('/blog/post/{code}', [", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Имена группы", "snippet": "Имена группы\nИмена маршрутов формируются иерархично, аналогично префиксам. Чтобы задать имя, используйте метод `name`.\n\n- Без группировки.\n\n```php\n$routes\n ->group(function(RoutingConfigurator $routes) {\n $routes->get('/blog/', [", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Генерация URL", "snippet": "Генерация URL\nИспользуйте объект роутера для создания ссылок по именам маршрутов.\n\n!!! note \"Примечание\"\n\n\n Генерация URL работает только для именованных маршрутов — при формировании ссылки нужно указать имя маршрута.\n\n\n\nПример формирова", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Миграция с устаревшего urlrewrite.php", "snippet": "Миграция с устаревшего urlrewrite.php\nДо появления роутинга в Bitrix Framework использовался файл `urlrewrite.php` для маршрутизации запросов до исполняемых файлов.\n\n!!! warning \"В новых проектах используйте роутинг\"\n\n\n Старые проекты мо", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Частые ошибки и решения", "snippet": "Частые ошибки и решения\n1. **Ошибка 404 после настройки роутинга**. Убедитесь, что изменения в `.htaccess` применены правильно и файл `routing_index.php` доступен.\n\n2. **Некорректная работа параметров маршрута**. Проверьте, что паттерны в м", "page": "docs-framework-routing", "path": "/docs/framework/routing/", "title": "Роутинг"}, {"heading": "Контроллеры", "snippet": "Контроллеры\nКонтроллер обрабатывает запрос, вызывает бизнес-логику и возвращает ответ. В Bitrix Framework за контроллеры отвечает класс `Bitrix\\Main\\Engine\\Controller`. Действия контроллера — это методы с суффиксом `Action`, например `listA", "page": "docs-framework-controllers", "path": "/docs/framework/controllers/", "title": "Контроллеры"}, {"heading": "Подготовить модуль", "snippet": "Подготовить модуль\nМатериал объединяет HTTP- и AJAX-примеры в одном учебном проекте. Выберите подходящий сценарий:\n\n- изучить оба способа вызова — выполните примеры по порядку,\n\n- использовать только HTTP-маршруты — создайте `Web\\Iblock` ", "page": "docs-framework-controllers", "path": "/docs/framework/controllers/", "title": "Контроллеры"}, {"heading": "Создать контроллер через консоль", "snippet": "Создать контроллер через консоль\nПеред запуском команды перейдите в каталог, в котором находится файл `bitrix.php`.\n\n!!! tip \"Совет\"\n\n\n Подробнее о консольном инструменте и справке по его командам читайте в статье [Консольные команды](./", "page": "docs-framework-controllers", "path": "/docs/framework/controllers/", "title": "Контроллеры"}, {"heading": "Зарегистрировать контроллер", "snippet": "Зарегистрировать контроллер\nСоздать класс контроллера недостаточно. Нужно зарегистрировать точку входа, через которую Bitrix Framework начнет обрабатывать действие.\n\nДля контроллера доступны два варианта регистрации:\n\n- HTTP-маршрут в `/lo", "page": "docs-framework-controllers", "path": "/docs/framework/controllers/", "title": "Контроллеры"}, {"heading": "Настроить HTTP-маршрут", "snippet": "Настроить HTTP-маршрут\nСоздайте файл `/local/routes/web.php` и зарегистрируйте маршруты для HTTP-примеров статьи:\n\n```php\n`. Указать другой URL в фильтре нельзя.\n\nДля пе", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтр CSRF-защиты", "snippet": "Фильтр CSRF-защиты\n`\\Bitrix\\Main\\Engine\\ActionFilter\\Csrf`\n\nПроверяет наличие и корректность CSRF-токена и блокирует действие, если проверка не пройдена. Необходим для защиты от CSRF-атак, особенно в формах и AJAX-запросах.\n\nАргументы:\n\n- ", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтр закрытия сессии", "snippet": "Фильтр закрытия сессии\n`\\Bitrix\\Main\\Engine\\ActionFilter\\CloseSession`\n\nЗакрывает сессию перед выполнением действия. Полезен для повышения производительности, когда изменения в сессии не требуются. Будьте внимательны, так как изменения в с", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтр области действия", "snippet": "Фильтр области действия\n`\\Bitrix\\Main\\Engine\\ActionFilter\\Scope`\n\nБлокирует действия для определенного scope. Полезен для ограничения доступа к действиям в зависимости от контекста выполнения, например, только для AJAX-запросов.\n\nАргументы:", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтр CORS-настроек", "snippet": "Фильтр CORS-настроек\n`\\Bitrix\\Main\\Engine\\ActionFilter\\Cors`\n\nУстанавливает заголовки для управления CORS. Используется для настройки CORS, когда требуется доступ к ресурсам с другого домена.\n\nАргументы:\n\n- `$origin` — заголовок `Access-Co", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтр типа контента", "snippet": "Фильтр типа контента\n`\\Bitrix\\Main\\Engine\\ActionFilter\\ContentType`\n\nРазрешает выполнение действия только для допустимых `content-type`. Полезен для обеспечения корректной обработки данных в зависимости от типа контента, например, JSON.\n\nАр", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Как использовать фильтры в контроллерах", "snippet": "Как использовать фильтры в контроллерах\nУказать фильтры для конкретных действий можно с помощью метода контроллера `configureActions`.\n\n```php\nuse Bitrix\\Main\\Engine\\ActionFilter\\Authentication;\nuse Bitrix\\Main\\Engine\\ActionFilter\\Cors;\n\nfi", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Фильтры по умолчанию", "snippet": "Фильтры по умолчанию\nПо умолчанию все действия контроллера используют фильтры `HttpMethod`, `Authentication` и `Csrf`. Чтобы изменить такое поведение, нужно переопределить метод контроллера `getDefaultPreFilters`.\n\nВ примере ниже, все дейст", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Дополняющие и вычитающие фильтры", "snippet": "Дополняющие и вычитающие фильтры\nЧтобы гибко работать с фильтрами, можно включать и отключать различные фильтры с помощью префиксов `+` и `-` в `configureActions()`.\n\n```php\nuse Bitrix\\Main\\Engine\\ActionFilter\\Authentication;\nuse Bitrix\\Mai", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Подменить ответ через фильтр", "snippet": "Подменить ответ через фильтр\nФильтры добавляют свои ошибки в контроллер. Пример работы с ошибками можно посмотреть в стандартном фильтре `Bitrix\\Main\\Engine\\ActionFilter\\HttpMethod::onBeforeAction`.\n\nФильтр может подменить результат через м", "page": "docs-framework-pre-post-filters", "path": "/docs/framework/pre-post-filters/", "title": "Пре- и постфильтры"}, {"heading": "Запрос (Request)", "snippet": "Запрос (Request)\nRequest — это абстрактный класс, который предоставляет информацию о текущем запросе. Он позволяет узнать метод и протокол, запрошенный URL, переданные параметры и другие данные. Класс расширяет [\\Bitrix\\Main\\Type\\ParameterD", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Параметры запроса", "snippet": "Параметры запроса\n- Получить параметр GET или POST\n\n ```php\n $value = $request->get(\"param\");\n $value = $request[\"param\"];\n ```\n\n- Получить GET-параметры\n\n ```php\n $value = $request->getQuery(\"param\"); // получить параме", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Данные о запросе", "snippet": "Данные о запросе\n- Получить метод запроса\n\n ```php\n $method = $request->getRequestMethod();\n ```\n\n- Проверить тип запроса\n\n ```php\n $flag = $request->isGet(); // вернет true, если GET-запрос\n $flag = $request->isPost(); ", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Класс HttpRequest", "snippet": "Класс HttpRequest\nHttpRequest — это класс, который управляет объектом Request. Он содержит информацию о текущем запросе, включая его тип и параметры. Этот класс помогает избежать использования глобальных переменных, которые применялись в ст", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Ответ (Response)", "snippet": "Ответ (Response)\nКласс \\Bitrix\\Main\\HttpResponse — это базовый класс для работы с HTTP-ответами. Он служит контейнером для:\n\n**HTTP-заголовков** [`\\Bitrix\\Main\\Web\\HttpHeaders`](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Web-HttpHead", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Стандартные форматы ответов", "snippet": "Стандартные форматы ответов\n- [AjaxJson](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Engine-Response-AjaxJson.html) — методы для JSON-ответов. Все ответы от контроллеров `\\Bitrix\\Main\\Engine\\Controller` имеют структуру, понятную для ", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Файлы и изображения", "snippet": "Файлы и изображения\n- [BFile](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Engine-Response-BFile.html) — работает с файлами. Используется для скачивания файлов из таблицы `b_file`.\n\n- [ResizedImage](https://docs.1c-bitrix.ru/api/clas", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Управление ответом", "snippet": "Управление ответом\nКласс [Redirect](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Engine-Response-Redirect.html) автоматически делает:\n\n- проверки безопасности,\n\n- редирект с 301 или 302 статусом.\n\n```php\n// сделать переадресацию с 30", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Преобразование данных {#converter}", "snippet": "Преобразование данных {#converter}\nКласс [Converter](https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Engine-Response-Converter.html) конвертирует строки и массивы. Для настройки преобразований класс использует битовые маски.\n\n| **Констант", "page": "docs-framework-request-response", "path": "/docs/framework/request-response/", "title": "Request и Response"}, {"heading": "Service Locator", "snippet": "Service Locator\nService Locator — это шаблон проектирования для управления сервисами приложения. Вместо создания сервисов напрямую, используется специальный объект — Service Locator. Он отвечает за создание и поиск сервисов, что упрощает их", "page": "docs-framework-service-locator", "path": "/docs/framework/service-locator/", "title": "Service Locator"}, {"heading": "Конфигурация сервиса", "snippet": "Конфигурация сервиса\nКонфигурация определяет способ создания объекта. Возможны три варианта:\n\n1. **Указать класс сервиса.** Service Locator создаст сервис вызвав `new $className`.\n\n ```php\n 'someModule.someServiceName' => [\n 'clas", "page": "docs-framework-service-locator", "path": "/docs/framework/service-locator/", "title": "Service Locator"}, {"heading": "Регистрация сервиса", "snippet": "Регистрация сервиса\nЧтобы обратиться к сервису, его нужно зарегистрировать одним из способов.\n\n1. **Через файл настроек bitrix/.settings.php**\n\n В Bitrix Framework файлы `.settings.php` используются для хранения конфигураций. Они находятс", "page": "docs-framework-service-locator", "path": "/docs/framework/service-locator/", "title": "Service Locator"}, {"heading": "Сессии", "snippet": "Сессии\nСессии в Bitrix Framework позволяют сохранять данные между запросами пользователя. Это важно для управления состоянием пользователя и персонализации его опыта на сайте.\n\nРабота с сессиями\nПрямое обращение к `$_SESSION` может привести", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Сессионный кеш", "snippet": "Сессионный кеш\nКешируйте данные пользователя, когда это необходимо. Использовать сессию для кеширования не рекомендуется, так как это может замедлить работу и вызвать блокировки. С версии main 20.5.400 доступен альтернативный вариант — созд", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Виды сессии", "snippet": "Виды сессии\nДля ускорения производительности существует несколько видов сессий, которые можно использовать в зависимости от потребностей вашего проекта.\n\nНеблокирующие сессии\nВ проектах с множественными AJAX-запросами часто возникают блокир", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Конфигурация хранения данных", "snippet": "Конфигурация хранения данных\nЯдро поддерживает четыре варианта хранения данных сессии: файлы, Redis, база данных и Memcache.\n\nСпособ хранения указывается в файле `/bitrix/.settings.php` в секции `session`. По умолчанию секция `session` може", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Использование Redis", "snippet": "Использование Redis\n```php\n// bitrix/.settings.php\nreturn [\n // ...\n 'session' => [\n 'value' => [\n 'mode' => 'default',\n 'handlers' => [\n 'general' => [\n 'type' => 'redis'", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Использование Memcache", "snippet": "Использование Memcache\n```php\n// bitrix/.settings.php\nreturn [\n // ...\n 'session' => [\n 'value' => [\n 'mode' => 'default',\n 'handlers' => [\n 'general' => [\n 'type' => 'mem", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Хранение в базе данных MySQL", "snippet": "Хранение в базе данных MySQL\nДанные хранятся в таблице `b_user_session`.\n\n```php\n// bitrix/.settings.php\nreturn [\n // ...\n 'session' => [\n 'value' => [\n 'mode' => 'default',\n 'handlers' => [\n ", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Дополнительные настройки", "snippet": "Дополнительные настройки\nСуществуют дополнительные настройки сессии, которые можно описать в `.settings.php`.\n\n```php\n// bitrix/.settings.php\nreturn [\n // ...\n 'session' => [\n 'value' => [\n 'lifetime' => (int),\n ", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Разделенный режим сессии", "snippet": "Разделенный режим сессии\nЧтобы включить разделенный режим сессии, внесите правки в конфигурационный файл `/bitrix/.settings.php`.\n\n1. Измените `session[mode]` на `separated`, чтобы включить разделенный режим сессии.\n\n2. Задайте время жизни ", "page": "docs-framework-sessions", "path": "/docs/framework/sessions/", "title": "Сессии"}, {"heading": "Cookie-файлы", "snippet": "Cookie-файлы\nДля работы с файлами cookie предназначен класс `Bitrix\\Main\\Web\\Cookie`. Он позволяет создавать cookie с такими параметрами, как имя, значение, срок действия и путь.", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Как установить cookie", "snippet": "Как установить cookie\nЧтобы задать cookie, используйте класс `Bitrix\\Main\\HttpResponse`.\n\n1. Импортируйте классы `Cookie` и `Context`.\n\n ```php\n use Bitrix\\Main\\Web\\Cookie;\n use Bitrix\\Main\\Context;\n ```\n\n2. Создайте объект cookie. ", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Как получить cookie", "snippet": "Как получить cookie\nЧтобы получить cookie, используйте класс `Bitrix\\Main\\HttpRequest`.\n\n1. Получите объект запроса. Используйте текущий контекст для доступа к запросу.\n\n ```php\n use Bitrix\\Main\\Context;\n\n $request = Context::getCurre", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Доступность через HTTP", "snippet": "Доступность через HTTP\n```php\n$cookie->setHttpOnly(true); // установить доступность cookie только через HTTP-протокол\n$cookie->getHttpOnly(); // получить текущее значение флага HttpOnly для объекта cookie. Флаг указывает, доступна ли cookie", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Атрибут SameSite", "snippet": "Атрибут SameSite\n```php\n$cookie->setSameSite('Lax'); // установить атрибут SameSite для cookie, он определяет политику отправки cookie в кросс-сайтовых запросах\n$cookie->getSameSite(); // получить текущее значение атрибута SameSite для cook", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Работа с cookie через AJAX", "snippet": "Работа с cookie через AJAX\nЧтобы добавить cookie через AJAX, используйте следующие примеры:\n\n```php\nuse Bitrix\\Main\\Application;\nuse Bitrix\\Main\\Web\\Cookie;\n\n$application = Application::getInstance();\n$context = $application->getContext();\n", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Шифрованные cookie", "snippet": "Шифрованные cookie\nШифрованные cookie `\\Bitrix\\Main\\Web\\CryptoCookie` позволяют передавать данные пользователю без раскрытия их содержимого и без изменения.\n\nДля шифрования данных ядром необходимо указать `crypto_key` в файле настроек `/bit", "page": "docs-framework-cookies", "path": "/docs/framework/cookies/", "title": "Cookie-файлы"}, {"heading": "Валидация", "snippet": "Валидация\nВалидация данных — это проверка информации на соответствие заданным правилам. Например, числовой идентификатор должен быть положительным, а email — соответствовать формату адреса.\n\nКак использовать валидацию\nВ Bitrix Framework вал", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Как создать правила в классе", "snippet": "Как создать правила в классе\n1. Создайте класс. Например, `User` со свойствами `id`, `email` и `phone`.\n\n ```php\n final class User\n {\n private ?int $id;\n private ?string $email;\n private ?string $phone;\n\n // ge", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Вложенные объекты", "snippet": "Вложенные объекты\nИспользуйте атрибут `#[Validatable]` для вложенных объектов.\n\n```php\nuse Bitrix\\Main\\Validation\\Rule\\Recursive\\Validatable;\nuse Bitrix\\Main\\Validation\\Rule\\NotEmpty;\nuse Bitrix\\Main\\Validation\\Rule\\PositiveNumber;\nclass Bu", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Валидация массивов", "snippet": "Валидация массивов\nАтрибут `#[ElementsType]` проверяет, что все элементы массива соответствуют одному из типов перечисления `\\Bitrix\\Main\\Validation\\Rule\\Enum\\Type`.\n\n- `Type::Integer` — целое число.\n\n- `Type::String` — строка.\n\n- `Type:", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Валидация в контроллерах", "snippet": "Валидация в контроллерах\nВ контроллерах валидация помогает убедиться в корректности данных из запроса.\n\n```php\nuse Bitrix\\Main\\Validation\\Rule\\NotEmpty;\nuse Bitrix\\Main\\Validation\\Rule\\PhoneOrEmail;\n\nfinal class CreateUserDto\n{\n public f", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Валидаторы без атрибутов", "snippet": "Валидаторы без атрибутов\nВалидаторы можно применять без атрибутов для разовой проверки данных, когда нет необходимости описывать правила в объекте. Это подходит для старого кода с массивами и нетипизированными переменными.\n\n```php\nuse Bitri", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Сообщение об ошибке после валидации", "snippet": "Сообщение об ошибке после валидации\nМожно указать свой текст ошибки, который будет возвращен после валидации.\n\n```php\nuse Bitrix\\Main\\Validation\\Rule\\PositiveNumber;\n\nclass User\n{\n public function __construct(\n #[PositiveNumber(er", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Получить сработавший валидатор", "snippet": "Получить сработавший валидатор\nРезультат валидации хранит ошибки `\\Bitrix\\Main\\Validation\\ValidationError`. Каждая ошибка содержит свойство `failedValidator`.\n\n```php\n$errors = $service->validate($dto)->getErrors();\nforeach ($errors as $err", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Доступные атрибуты и валидаторы", "snippet": "Доступные атрибуты и валидаторы\nBitrix Framework предоставляет готовые атрибуты и валидаторы для самых частых сценариев проверки данных.\n\nСвойства:\n\n- `ElementsType` — проверка типа элементов массива,\n\n- `Email` — валидация email,\n\n- `In", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Как создать собственные валидаторы", "snippet": "Как создать собственные валидаторы\nКаждый валидатор реализует интерфейс `\\Bitrix\\Main\\Validation\\Validator\\ValidatorInterface` с методом `public function validate(mixed $value): ValidationResult`.\n\nВалидатор выполняет простую задачу — прове", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Пример валидатора Min", "snippet": "Пример валидатора Min\n1. Класс `Min` реализует интерфейс `ValidatorInterface`.\n\n2. Конструктор принимает минимальное значение.\n\n3. Метод `validate` создает объект `ValidationResult`, который хранит результаты проверки.\n\n - Сначала он про", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Как создать атрибуты валидации", "snippet": "Как создать атрибуты валидации\nАтрибуты валидации разделены на два типа: для свойств и для классов.", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Атрибуты свойств", "snippet": "Атрибуты свойств\nАтрибуты свойств реализуют интерфейс `\\Bitrix\\Main\\Validation\\Rule\\PropertyValidationAttributeInterface`. Они используют метод `validateProperty(mixed $propertyValue): ValidationResult` для проверки значений свойств.\n\nПриме", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Атрибуты класса", "snippet": "Атрибуты класса\nАтрибуты класса реализуют интерфейс `\\Bitrix\\Main\\Validation\\Rule\\ClassValidationAttributeInterface`. Они используют метод `validateObject(object $object): ValidationResult` для проверки объектов.\n\nПример атрибута для провер", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Сообщение об ошибке для атрибута", "snippet": "Сообщение об ошибке для атрибута\nЕсли вы наследуетесь от `AbstractClassValidationAttribute` или `AbstractPropertyValidationAttribute`, можно задать собственное сообщение об ошибке через свойство `$errorMessage`. Это позволит вернуть одну ош", "page": "docs-framework-validation", "path": "/docs/framework/validation/", "title": "Валидация"}, {"heading": "Результат работы и ошибки", "snippet": "Результат работы и ошибки\nПри разработке веб-приложений, которые выполняют не только CRUD-операции, важно правильно передавать результаты работы и ошибки.\n\nДля передачи результата обычно используют массивы или объекты данных DTO. Ошибки пер", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Класс \\\\Bitrix\\\\Main\\\\Result", "snippet": "Класс \\\\Bitrix\\\\Main\\\\Result\nКласс `Result` хранит результаты операций и ошибки. Он помогает определить, прошла ли операция успешно.\n\nМетоды класса:\n\n- `setData($data)` — сохраняет данные результата,\n\n- `isSuccess()` — проверяет, успешна ", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Пример использования Result", "snippet": "Пример использования Result\nФункция `updateUserData` проверяет идентификатор пользователя, обновляет данные и возвращает результат.\n\n- Если идентификатор пользователя неверный, добавляется ошибка.\n\n- Если обновление не удалось, добавляетс", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Типизация данных", "snippet": "Типизация данных\nПо умолчанию данные представлены в виде обычного массива. Отсутствие строгой типизации может привести к проблемам.\n\nЕсли нужно передать большой объем данных, создайте класс-наследник от объекта результата. Используйте свойс", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Класс \\\\Bitrix\\\\Main\\\\ErrorCollection", "snippet": "Класс \\\\Bitrix\\\\Main\\\\ErrorCollection\nКласс `ErrorCollection` внутри объекта `Result` собирает ошибки и управляет ими. При необходимости можно работать с этой коллекцией напрямую.\n\nМетоды класса:\n\n- `add(array $errors)` — добавляет ошибки,", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Практические рекомендации", "snippet": "Практические рекомендации\n- Проверяйте `isSuccess()` перед получением данных.\n\n- Используйте коды ошибок для их идентификации.\n\n- Группируйте ошибки в `ErrorCollection`.\n\n- Записывайте ошибки в логи при необходимости.\n\n- Используйте по", "page": "docs-framework-results-and-errors", "path": "/docs/framework/results-and-errors/", "title": "Результат работы и ошибки"}, {"heading": "Компоненты", "snippet": "Компоненты\nКомпоненты в Bitrix Framework — это основной инструмент для отображения информации. Они позволяют настраивать вывод данных и добавлять функциональность в систему.\n\nЧто такое компонент\nКомпонент — это виджет, который берет данные ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Когда использовать компоненты", "snippet": "Когда использовать компоненты\nКомпоненты подходят для:\n\n- часто используемых областей, например, форм авторизации и подписки.\n\n- динамически обновляемой информации: новостные ленты, случайные фото.\n\n- любых операций с данными.\n\nКомпонент", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Структура компонента", "snippet": "Структура компонента\nКомпонент в Bitrix Framework хранит все необходимые файлы в одной папке. Эти файлы не могут использоваться отдельно.\n\nПапка компонента может содержать:\n\n- `/lang/` — языковые файлы для переводов.\n\n- `/templates/` — ша", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Именование", "snippet": "Именование\nНазвание подпапки в `/local/components/` образует пространство имен (namespace) компонентов. Например, системные компоненты находятся в пространстве имен `bitrix`. Для пользовательских компонентов необходимо создать свое простран", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Как подключить компонент", "snippet": "Как подключить компонент\nПодключение компонента выполняется так:\n\n```php\nIncludeComponent(\n $componentName,\n $componentTemplate,\n $arParams = array(),\n $parentComponent = null,\n $arFunctionParams = array()", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Пример файла class.php", "snippet": "Пример файла class.php\n```php\n Loc::getMessage(\"COMP_NAME\"),\n \"DESCRIPTION\" => Loc::getMessage(\"COMP_DESCR\"),\n \"ICON\" => \"/images/icon.gif\",\n ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Массив \\$arComponentDescription", "snippet": "Массив \\$arComponentDescription\nФайл содержит массив `$arComponentDescription`, который описывает основные характеристики компонента. Ключи массива:\n\n- `NAME` — название компонента,\n\n- `DESCRIPTION` — описание компонента,\n\n- `ICON` — пут", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Файл .parameters.php", "snippet": "Файл .parameters.php\nФайл `.parameters.php` содержит описание входных параметров компонента. Параметры необходимы для создания формы ввода свойств компонента в визуальном редакторе и других инструментах среды Bitrix. Описание параметров не ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Пример файла .parameters.php", "snippet": "Пример файла .parameters.php\n```php\n \"asc\"],\n [\"ACTIVE\" => \"Y\"]\n);\nwhile ($arIBlockTyp", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Массив \\$arComponentParameters", "snippet": "Массив \\$arComponentParameters\nФайл содержит массив `$arComponentParameters`, который описывает входные параметры компонента. Он может включать выборку дополнительных данных, например, для формирования выпадающего списка типов информационны", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Ключ GROUPS", "snippet": "Ключ GROUPS\nМассив групп параметров компонента. Группы помогают организовать параметры в визуальных средствах Bitrix. Пример группы:\n\n```php\n\"SETTINGS\" => [\n \"NAME\" => \"Настройки\",\n \"SORT\" => 100\n]\n```\n\n**Перечень стандартных групп**\n\n| К", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Ключ PARAMETERS", "snippet": "Ключ PARAMETERS\nМассив параметров компонента. Каждый параметр описывается следующим образом:\n\n```php\n\"код параметра\" => [\n \"PARENT\" => \"код группы\", // если нет — ставится ADDITIONAL_SETTINGS\n \"NAME\" => \"название параметра на текущем я", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Тип параметров CUSTOM", "snippet": "Тип параметров CUSTOM\nВ параметре `TYPE` используйте значение `CUSTOM`, когда стандартных настроек компонента недостаточно. Например, в форму настроек нужно добавить интерактивный элемент: кнопку, карту или ползунок.\n\nДля `TYPE=CUSTOM` укаж", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Папки локализаций", "snippet": "Папки локализаций\nКомпоненты и их шаблоны поддерживают вывод сообщений на разных языках, автоматически отображая текст на языке пользователя.\n\nСтруктура языковых файлов\n- Каждой языковой версии соответствует своя папка: `/ru/`, `/en/` и т", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Подсказки в параметрах компонента", "snippet": "Подсказки в параметрах компонента\nBitrix Framework позволяет добавлять подсказки к параметрам компонента. Для этого в языковой папке `/lang/` создайте массив `$MESS`, где ключи — это параметры компонента с суффиксом `_TIP`, а значения — сам", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Виды шаблонов", "snippet": "Виды шаблонов\n1. **Системные шаблоны**: поставляются вместе с дистрибутивом и находятся в подпапке `templates` папки компонента.\n\n2. **Пользовательские шаблоны**: изменены под нужды конкретного сайта и должны находиться в папках шаблонов са", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Переменные в шаблоне", "snippet": "Переменные в шаблоне\n- `$templateFile` — путь к шаблону относительно корня сайта.\n\n- `$arResult` — массив результатов работы компонента.\n\n- `$arParams` — массив входящих параметров компонента.\n\n- `$arLangMessages` — массив языковых сооб", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Структура шаблона", "snippet": "Структура шаблона\n- `/lang/` — файлы языковых сообщений.\n\n- `result_modifier.php` — подключается перед шаблоном для изменения `$arResult` и `$arParams`.\n\n- `component_epilog.php` — подключается после исполнения шаблона.\n\n- `style.css` —", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Поиск шаблона системой", "snippet": "Поиск шаблона системой\nСистема ищет подходящий шаблон по алгоритму.\n\n1. Ищет в `/local/templates/текущий_шаблон_сайта/components/`.\n\n2. Если не найден, ищет в `/local/templates/.default/components/`.\n\n3. Если не найден, ищет в `/bitrix/temp", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Работа с AJAX", "snippet": "Работа с AJAX\nДля корректной работы AJAX необходимо, чтобы в шаблоне компонента присутствовали элементы с `id=\"navigation\"` для навигации и `id=\"pagetitle\"` для заголовка. Например:\n\n```php\n count($arResult['ITEMS']),\n 'LAST_UPDATED' => $arResult['LAST", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Особенности использования component_epilog.php", "snippet": "Особенности использования component_epilog.php\nФайл `component_epilog.php` подключается сразу после выполнения шаблона. Если в компоненте после подключения шаблона идут другие операции, они выполнятся после `component_epilog.php`. В случае ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Кеширование компонентов", "snippet": "Кеширование компонентов\nВ массиве`$arParams` содержится набор параметров компонента. Файл `class.php` работает с входными параметрами запроса и базой данных, формируя результат в массив `$arResult`. Шаблон компонента преобразует результат ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Автокеширование", "snippet": "Автокеширование\nАвтокеширование можно отключить на весь сайт в административной части *Настройки > Настройки продукта > Автокеширование*. Обычно оно выключено на этапе разработки и включается перед сдачей проекта. Разработчик должен самосто", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Реализация в class.php", "snippet": "Реализация в class.php\nОбработчик запросов в классе компонента (файл `class.php`) позволяет инкапсулировать весь код в одном классе, повторно использовать методы, данные и параметры компонента, а также использовать языковые фразы и шаблоны ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Реализация в ajax.php", "snippet": "Реализация в ajax.php\nОбработчик контроллера запросов в файле `ajax.php` позволяет создать легковесный обработчик AJAX-запросов, выделяя логику из компонента. Чтобы его реализовать, создайте в корне компонента файл `ajax.php` и определите м", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Подготовка параметров для AJAX", "snippet": "Подготовка параметров для AJAX\nЧтобы передать параметры из компонента в JavaScript, необходимо описать их в методе `listKeysSignedParameters`. Это позволяет использовать те же параметры, которые были при отображении компонента на странице.\n", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Выполнение AJAX-запросов", "snippet": "Выполнение AJAX-запросов\nДля выполнения AJAX-запросов используйте `BX.ajax.runComponentAction`, передавая подписанные параметры.\n\n```javascript\nBX.ajax.runComponentAction(this.componentName, action, {\n mode: 'class',\n signedParameters", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "\\$arParams", "snippet": "\\$arParams\nПеременная `$arParams` — это массив входных параметров компонента. Ключи массива — названия параметров, значения — их содержимое.\n\nФункция `htmlspecialcharsEx` применяется ко всем значениям параметров перед подключением компонент", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Ссылки в PHP", "snippet": "Ссылки в PHP\nСсылки (references) в PHP позволяют обращаться к одним и тем же данным по разным именам. Если `$arParams` и `$arResult` изменены в коде компонента, они будут доступны измененными и в шаблоне.\n\nУчтите следующие нюансы:\n\n- Если ", "page": "docs-framework-components", "path": "/docs/framework/components/", "title": "Компоненты"}, {"heading": "Расширения", "snippet": "Расширения\nРасширение — способ организации JS и CSS кода в 1С-Битрикс: Управление Сайтом и Битрикс24. Расширения помогают организовать код, обеспечивая его модульность и управляемость. Они позволяют объединять файлы JavaScript и CSS в бандл", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Структура", "snippet": "Структура\nПример структуры расширения `myextension`:\n\n- `src` — исходные файлы.\n\n- `dist` — бандлы для браузера.\n\n- `bundle.config.js` — конфигурационный файл для сборщика.\n\n- `config.php` — конфигурационный файл экстеншна.\n\n- `lang` —", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Директория src", "snippet": "Директория src\nВ директории `src` размещаются исходные файлы в формате ES6. Из этих файлов на основании данных файла конфигурации и внутренних ссылок будут созданы финальные версии в формате ES5 — бандлы. Они используются для подключения в ", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Файл bundle.config.js", "snippet": "Файл bundle.config.js\nФайл конфигурации сборщика.\n\n- Базовая конфигурация.\n\n ```javascript\n module.exports = {\n input: './src/app.js',\n output: './dist/app.bundle.js',\n };\n ```\n\n В данном файле конфигурации не указыва", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Файл config.php", "snippet": "Файл config.php\nКонфигурационный файл расширения `config.php` определяет, какие файлы необходимо подключить на странице.\n\nПри использовании `@bitrix/cli` файл `config.php` будет автоматически создан при сборке и будет обновляться по мере не", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Директория @types", "snippet": "Директория @types\nДиректория может содержать файлы `.d.ts` с описанием публичного JS API расширения на TypeScript. Рекомендуем использовать файлы `*.d.ts` для описания API библиотек, написанных на ES5. Описывать код ES6 не нужно.\n\nПри", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Директория test", "snippet": "Директория test\nДиректория должна содержать вложенные директории и файлы Mocha-тестов. Для каждого файла необходимо создать директорию с именем тестируемого файла и файлом с тестами в формате `.test.js`.\n\nЕсли структура `src` им", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Использование расширений", "snippet": "Использование расширений\nВ PHP загрузите и подключите расширение на странице с помощью метода`\\Bitrix\\Main\\UI\\Extension::load`. Этот метод принимает в качестве параметра имя расширения либо массив имен.\n\n```php\n\\Bitrix\\Main\\UI\\Extension::lo", "page": "docs-framework-extensions", "path": "/docs/framework/extensions/", "title": "Расширения"}, {"heading": "Объект приложения и контекст", "snippet": "Объект приложения и контекст\nВ Bitrix Framework приложение и контекст управляют обработкой веб-запросов. Эти концепции важны для работы с ядром системы и взаимодействия с данными.\n\nОбъект приложения\nПриложение в Bitrix Framework инициализир", "page": "docs-framework-app-and-context", "path": "/docs/framework/app-and-context/", "title": "Объект приложения и контекст"}, {"heading": "Контекст", "snippet": "Контекст\n**Контекст** связан с конкретным хитом и содержит запрос, ответ и серверные параметры. Он изменяется в зависимости от хита, что позволяет обрабатывать каждый запрос индивидуально.\n\n- **Наследование**. Контекст наследует [`Bitrix\\M", "page": "docs-framework-app-and-context", "path": "/docs/framework/app-and-context/", "title": "Объект приложения и контекст"}, {"heading": "Запрос", "snippet": "Запрос\nКонтекст включает в себя [запрос](./request-response), который представляет данные текущего хита. Запрос содержит информацию о параметрах запроса и методе его выполнения.\n\n- **Получение запроса**. Чтобы получить запрос, выполните:\n\n", "page": "docs-framework-app-and-context", "path": "/docs/framework/app-and-context/", "title": "Объект приложения и контекст"}, {"heading": "Агенты и фоновые задачи", "snippet": "Агенты и фоновые задачи\nАгенты и фоновые задачи помогают выполнять PHP-код автоматически.\n\n- Агенты — запускают код по расписанию.\n\n- Фоновые задачи — после отправки ответа пользователю.", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Отличия агентов от фоновых задач", "snippet": "Отличия агентов от фоновых задач\n| **Характеристика** | **Агенты** | **Фоновые задачи** |\n|--------------------|-------------------------------------------------------", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Агенты", "snippet": "Агенты\nАгент — это запись в базе данных, которая содержит:\n\n- код для выполнения,\n\n- время следующего запуска,\n\n- интервал выполнения,\n\n- тип агента: периодический или непериодический.\n\nАгенты выполняются в однопоточном режиме. Если аге", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Зарегистрировать агента", "snippet": "Зарегистрировать агента\nДля работы с агентами используйте методы класса [CAgent](https://dev.1c-bitrix.ru/api_help/main/reference/cagent/index.php).\n\n- Метод `addAgent` добавляет агент.\n\n ```php\n CAgent::AddAgent(\n \"MyFunction();", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Создать агента через интерфейс", "snippet": "Создать агента через интерфейс\nАгента можно добавить через административный раздел на странице *Настройки > Настройки продукта > Агенты*. Нажмите *Добавить агента* и заполните параметры, аналогичные регистрации через функцию `addAgent`.\n\n![", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Частично перевести запуск на cron", "snippet": "Частично перевести запуск на cron\nАгенты можно перевести на cron частично. Система продолжит запускать агенты при посещениях, а cron будет запускать только часть агентов.\n\n1. Откройте страницу *Настройки > Инструменты > Командная PHP-строка", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Полностью перевести запуск на cron", "snippet": "Полностью перевести запуск на cron\nАгенты не будут зависеть от посещаемости сайта и сработают точно по расписанию.\n\n1. Откройте страницу *Настройки > Инструменты > Командная PHP-строка*. Выполните код, который полностью отключит запуск аген", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Вернуть запуск агентов на хитах", "snippet": "Вернуть запуск агентов на хитах\n1. В таблице `b_option` удалите записи `NAME = agents_use_crontab` и `NAME = check_agents`.\n\n2. Очистите управляемый кеш в административном разделе.\n\n3. Удалите изменения из `/bitrix/php_interface/dbconn.php`", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Где размещать функции", "snippet": "Где размещать функции\n- **В модуле.** Укажите модуль при регистрации агента. Функция становится доступной после подключения модуля, то есть файла `/bitrix/modules/[MODULE_ID]/include.php`.\n\n ```php\n CAgent::AddAgent(\"Function();\", \"mod", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Примеры агентов", "snippet": "Примеры агентов\n1. Очистить статистику.\n\n ```php\n CAgent::AddAgent(\n \"CStatistic::CleanUpStatistics_2();\", // имя функции\n \"statistic\", // идентификатор модуля\n \"N\", ", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Ограничения агентов", "snippet": "Ограничения агентов\n1. Нет доступа к переменной `$USER`.\n\n2. Нельзя использовать авторизацию методом `Authorize`.\n\n3. Нет константы `SITE_ID`.\n\n4. Нельзя определить заранее язык на многоязычных сайтах.\n\nФоновые задачи\nФоновые задачи выполня", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Добавить фоновую задачу", "snippet": "Добавить фоновую задачу\nМетод `addBackgroundJob` добавляет фоновую задачу.\n\n```php\n\\Bitrix\\Main\\Application::addBackgroundJob(\n $job,\n $args,\n $priority\n)\n```\n\n- `$job` — вызываемая функция или метод. В качестве значения можно пер", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "Примеры фоновых задач", "snippet": "Примеры фоновых задач\n1. Базовый пример с функцией отправки письма.\n\n ```php\n $app = \\Bitrix\\Main\\Application::getInstance();\n $app->addBackgroundJob(\n [EmailService::class, 'sendWelcome'],\n ['user@example.com', 'Добро пож", "page": "docs-framework-background-jobs", "path": "/docs/framework/background-jobs/", "title": "Агенты и фоновые задачи"}, {"heading": "События", "snippet": "События\nСобытие — это действие или изменение состояния системы, например, нажатие кнопки пользователем или завершение загрузки данных. События уведомляют части приложения об изменениях, что позволяет системе реагировать на них.", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Базовое использование", "snippet": "Базовое использование\nЧтобы создать и отправить событие, используйте класс `Bitrix\\Main\\Event` и его метод `send`.\n\nПример отправки события:\n\n```php\n$event = new \\Bitrix\\Main\\Event('my.helpdesk', 'TicketClosed');\n$event->send();\n```\n\nПример", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Создание события", "snippet": "Создание события\nЧтобы создать событие, используйте команду `make:event`.\n\nПример создания события:\n\n```bash prompt=\"$\"\n$ php bitrix.php make:event TicketClosed -m my.helpdesk --no-interaction\n```\n\nЭта команда создаст файл `/local/modules/m", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Создание обработчика", "snippet": "Создание обработчика\nЧтобы создать обработчик, используйте команду `make:eventhandler`.\n\nПример создания обработчика:\n\n```bash prompt=\"$\"\n$ php bitrix.php make:eventhandler TicketClosed --event-module my.helpdesk --handler-module my.helpdes", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Результаты событий", "snippet": "Результаты событий\nОбработчик события может возвращать результат. Это необязательно — можно вернуть `null` или ничего для методов с типом `void`. Если обработчик должен повлиять на дальнейшую логику выполнения, например, запретить операцию ", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Регистрация обработчиков", "snippet": "Регистрация обработчиков\nЧтобы обработчики `BeforeTicketCloseEventHandler` и `TicketClosedEventHandler` начали работать, их нужно зарегистрировать. Используйте для этого объект `Bitrix\\Main\\EventManager` и его метод `registerEventHandler`:\n", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Старые события и режим совместимости", "snippet": "Старые события и режим совместимости\nВ продукте есть события в старом формате, например `OnBeforeUserAdd`. У них нет объекта `Bitrix\\Main\\Event`, и в обработчик передается произвольный набор аргументов.\n\nПример обработчика для старого событ", "page": "docs-framework-events", "path": "/docs/framework/events/", "title": "События"}, {"heading": "Очереди сообщений", "snippet": "Очереди сообщений\nОчереди в Bitrix Framework выполняют задачи в фоне. Это помогает разгрузить систему, если какие-то операции требуют много времени или ресурсов.\n\n!!! warning \"Внимание\"\n\n\n Функционал очередей находится в альфа-версии раз", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "1\\. Создать класс сообщения", "snippet": "1\\. Создать класс сообщения\nСообщение должно поддерживать JSON-сериализацию.\n\n- Используйте поля простых типов для автоматической сериализации: `string`, `int`, `float`, `bool`, `array`.\n\n- Реализуйте метод `jsonSerialize()`, если нужно п", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "2\\. Создать класс обработчика", "snippet": "2\\. Создать класс обработчика\nОбработчик получает сообщения из очереди и выполняет нужные действия.\n\n```php\nuse Bitrix\\Main\\Messenger\\Entity\\MessageInterface;\nuse Bitrix\\Main\\Messenger\\Receiver\\AbstractReceiver;\n\nclass MyReceiver extends Ab", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "4\\. Отправить сообщение", "snippet": "4\\. Отправить сообщение\nСообщение поступит в очередь и обработается в фоне.\n\n```php\n$message = new MyMessage('Мое первое сообщение!', 12345);\n$message->send('first_queue');\n```\n\nКонфигурация очередей {#settings}\nСистему очередей нужно настр", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Глобальная конфигурация", "snippet": "Глобальная конфигурация\nГлобальную конфигурацию настраивают, когда очереди и брокер планируют использовать в разных модулях, например, для интеграции между модулями.\n\nПо умолчанию в `/bitrix/.settings.php` создается секция `messenger` с пар", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Параметры", "snippet": "Параметры\nРежим `run_mode` — определяет как обрабатывать сообщения:\n\n- `web` — в фоновых задачах,\n\n- `cli` — в консольном скрипте.\n\nПри значении `cli` нужно настроить запуск скрипта вручную командой:\n\n```bash prompt=\"$\"\n$ php bitrix.php m", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Модульная конфигурация", "snippet": "Модульная конфигурация\nВ `.settings.php` модуля указываются очереди, используемые этим модулем.\n\n```php\nreturn [\n ...\n 'messenger' => [\n 'value' => [\n 'queues' => [\n 'google_section_sync' => [\n ", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Параметры", "snippet": "Параметры\nБрокеры `brokers` — доступные хранилища сообщений. Структура объекта полностью идентична глобальной конфигурации.\n\nОчереди `queues` — доступные очереди. Ключ — идентификатор очереди, а значение — параметры очереди:\n\n- `handler` —", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Ограничение количества обрабатываемых сообщений", "snippet": "Ограничение количества обрабатываемых сообщений\nКоличество обрабатываемых сообщений настраивается двумя параметрами очереди.\n\n1. Параметр `limit` задает количество сообщений, которые обработчик выбирает из очереди за один раз.\n\n **Пример.", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Повторная обработка сообщений", "snippet": "Повторная обработка сообщений\nСообщение может не обработаться с первой попытки, например, из-за временной недоступности сервиса. Тогда сообщение нужно обработать повторно.\n\nИспользуйте повторную обработку:\n\n- при работе с внешними API,\n\n- ", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Пример конфигурации", "snippet": "Пример конфигурации\n```php\nreturn [\n 'messenger' => [\n 'value' => [\n 'queues' => [\n 'second_queue' => [\n 'handler' => MyReceiver::class,\n 'retry_strategy' => [\n ", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Своя таблица для сообщений", "snippet": "Своя таблица для сообщений\nПри работе с `DBBroker` сообщения сохраняются в базу данных. По умолчанию используется таблица `b_main_messenger_message`. Можно создать отдельную таблицу для своего модуля.\n\n1. Создайте класс-наследник `Messenger", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Запуск обработчика очередей", "snippet": "Запуск обработчика очередей\nСистема поддерживает два режима обработки.\n\n1. `web` — обработка через фоновые задачи. Работает по умолчанию и без дополнительных настроек.\n\n2. `cli` — консольный режим. Требует дополнительной настройки и предост", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Обработчики сообщений", "snippet": "Обработчики сообщений\nКаждая очередь использует свой обработчик. Он должен:\n\n- обработать сообщение,\n\n- выбросить исключение при ошибке.\n\nЧтобы создать обработчик, наследуйтесь от класса `AbstractReceiver` и реализуйте метод `process`. Ме", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Типы исключений", "snippet": "Типы исключений\nИспользуйте разные исключения для разных сценариев.\n\n- `UnprocessableMessageException` — сообщение не подходит для этого обработчика. Пример: в очередь для обработки задач пришло сообщение о пользователе.\n\n- `Unrecoverable", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Пример обработчика сообщений в консольном режиме", "snippet": "Пример обработчика сообщений в консольном режиме\nВ примере обработчик `SomeReceiver` используется для конкретной очереди. При получении сообщения он выводит его `ID`. В `cli`\\-режиме воркер нужно запускать вручную. Он проверяет очередь в ци", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Собственная реализация", "snippet": "Собственная реализация\nДля особых сценариев обработки можно реализовать собственный обработчик через интерфейс `ReceiverInterface`.\n\n```php\ninterface ReceiverInterface\n{\n /**\n * Основной метод обработки\n * @throws ReceiverExcepti", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Работа с сообщениями", "snippet": "Работа с сообщениями\nСообщения — это контейнеры данных для передачи через очередь. Они должны реализовывать `\\Bitrix\\Main\\Messenger\\Entity\\MessageInterface`, но лучше расширять класс `\\Bitrix\\Main\\Messenger\\Entity\\AbstractMessage`.\n\nКлючевы", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Отправить сообщение с дополнительным параметром", "snippet": "Отправить сообщение с дополнительным параметром\nСообщение отправляется с двумя параметрами, которые применятся при постановке в очередь:\n\n- `DelayParam` — отложить обработку на 1 час,\n\n- `ItemIdParam` — отметить сообщение идентификатором ", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Особенности работы с отложенной обработкой", "snippet": "Особенности работы с отложенной обработкой\nСообщения могут обрабатываться не сразу, что требует особого подхода к их формированию.\n\nЕсли сообщение обрабатывается с задержкой, в него нужно включать все данные, которые потребуются обработчику", "page": "docs-framework-messenger", "path": "/docs/framework/messenger/", "title": "Очереди сообщений"}, {"heading": "Временное хранение", "snippet": "Временное хранение\nВ некоторых сценариях нужно сохранить данные на определенный срок и гарантировать их доступность для чтения. Для этого используют:\n\n- сессии — подходят для хранения данных в рамках одной пользовательской сессии, но очища", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Архитектура", "snippet": "Архитектура\nХранилища основаны на стандарте PSR-16 (SimpleCache). Стандарт задает единый интерфейс работы с временными данными и упрощает замену реализаций.\n\nНа его основе используется следующая иерархия интерфейсов:\n\n- `\\Bitrix\\Main\\Data\\", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Установить значение", "snippet": "Установить значение\nМетод `set($key, $value, $ttl = null)` сохраняет значение по указанному ключу.\n\n- `$key` — строка до 255 символов. Используйте формат `модуль.фича.уникальный_ключ`, например, `mymodule.feature_processing.feature123`.\n\n-", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Прочитать значение", "snippet": "Прочитать значение\nМетод `get($key, $default = null)` получает значение по ключу `$key`. Если ключ не найден или истек его срок, возвращает `$default`.\n\n- `$key` — ключ для поиска значения.\n\n- `$default` — значение, которое вернется, если", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Прочитать несколько значений", "snippet": "Прочитать несколько значений\nМетод `getMultiple($keys, $default = null)` получает несколько значений по массиву ключей.\n\n- `$keys` — массив ключей.\n\n- `$default` — значение, которое вернется для ключей, которые не найдены.\n\n```php\n$values", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Удалить несколько значений", "snippet": "Удалить несколько значений\nМетод `deleteMultiple($keys)` удаляет несколько записей одновременно.\n\n- `$keys` — массив ключей для удаления.\n\n```php\n$storage->deleteMultiple([\n 'mymodule.feature_processing.feature123',\n 'mymodule.featur", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Декоратор с отложенным сохранением", "snippet": "Декоратор с отложенным сохранением\n`DeferredStorageDecorator` накапливает изменения в памяти и записывает их в базу данных одним пакетом. Это снижает количество операций записи и повышает производительность.\n\nИспользуйте декоратор, если вып", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Создать декоратор", "snippet": "Создать декоратор\nЧтобы создать декоратор, передайте ему базовое хранилище.\n\n```php\n$baseStorage = \\Bitrix\\Main\\DI\\ServiceLocator::getInstance()\n ->get(\\Bitrix\\Main\\Data\\Storage\\PersistentStorageInterface::class)\n;\n\n$deferredStorage = ne", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Сбросить кешированное значение", "snippet": "Сбросить кешированное значение\nМетод `reset($key)` удаляет значение из внутреннего кеша. Следующий `get()` прочитает данные напрямую из из базового хранилища. Это полезно, если данные могут измениться другим процессом.\n\n- `$key` — ключ, зн", "page": "docs-framework-storage", "path": "/docs/framework/storage/", "title": "Временное хранение"}, {"heading": "Консольные команды", "snippet": "Консольные команды\nКонсольные команды в Bitrix Framework — это инструменты для выполнения операционных задач через терминал. Они работают как PHP-скрипты и умеют:\n\n- принимать аргументы и опции,\n\n- выполнять долгие операции без ограничени", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Встроенные команды", "snippet": "Встроенные команды\nBitrix Framework включает готовые команды для разработки.", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Генерация кода", "snippet": "Генерация кода\nКоманды `make` генерируют код объектов.\n\n!!! note \"Примечание\"\n\n\n Команды `make:entity`, `make:мodule`, `make:request`, `make:service`, `make:event`, `make:eventandler`, `make:message`, `make:messagehandler,` `make:agent` ", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Создает класс в папке lib/Infrastructure/Agent/FeatureName/", "snippet": "Создает класс в папке lib/Infrastructure/Agent/FeatureName/\n$ php bitrix.php make:agent MyAgent -m my.module --context=FeatureName -n\n```\n\nORM\nКоманда `orm:annotate` сканирует ORM-сущности и генерирует аннотации для их полей.\n\n```bash promp", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Проиндексировать файлы по конкретному пути", "snippet": "Проиндексировать файлы по конкретному пути\n$ php bitrix.php translate:index --path=/local/modules/my.module\n```\n\nОбновления\nКоманды обновления `update` показывают список изменений и запрашивают подтверждение перед выполнением.\n\n- `update:m", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Создать новую команду", "snippet": "Создать новую команду\nКонсольная команда в Bitrix Framework — это PHP-класс, который наследуется от `Symfony\\Component\\Console\\Command\\Command`.\n\n!!! tip \"Совет\"\n\n\n Подробную информацию о создании команд, их структуре и возможностях смот", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Где разместить файлы команд", "snippet": "Где разместить файлы команд\nФайлы команд рекомендуется хранить в каталоге модуля в папке `/lib/command/`.\n\nПример структуры модуля с одним классом команды:\n\n```\n/local/modules/partner.module/\n├── .settings.php # Регистрация команд\n", "page": "docs-framework-console-commands", "path": "/docs/framework/console-commands/", "title": "Консольные команды"}, {"heading": "Конфигурация", "snippet": "Конфигурация\nКонфигурация подключения к базе данных в Bitrix Framework хранится в файле `/bitrix/.settings.php` в секции `connections`.\n\n```php\n'connections' => [\n 'value' => [\n // Основное соединение с базой данных\n 'defau", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Классы для работы с базой данных", "snippet": "Классы для работы с базой данных\nПараметр `className` определяет класс для работы с базой данных.\n\nОсновные СУБД:\n\n- MySQL — `\\Bitrix\\Main\\DB\\MysqliConnection`, требует расширение `mysqli`,\n\n- PostgreSQL — `\\Bitrix\\Main\\DB\\PgsqlConnection", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Режимы подключения", "snippet": "Режимы подключения\nПараметр `options` управляет режимом подключения к базе данных. Принимает числовые флаги:\n\n- `1` (`Connection::PERSISTENT`) — постоянное соединение, не закрывается после выполнения запроса,\n\n- `2` (`Connection::DEFERRED", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Добавить дополнительное соединение", "snippet": "Добавить дополнительное соединение\nЧтобы добавить дополнительное соединение с базой данных, дополните секцию `connections` в файле конфигурации `/bitrix/.settings.php`.\n\n```php\n'connections' => [\n 'value' => [\n // Основное соедине", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Подключить key-value хранилище {#key-value}", "snippet": "Подключить key-value хранилище {#key-value}\n\nMemcache\nКласс подключения — `\\Bitrix\\Main\\Data\\MemcacheConnection`.\n\n```php\n'memcache' => [\n 'className' => \\Bitrix\\Main\\Data\\MemcacheConnection::class,\n 'host' => '127.0.0.1',\n 'port' ", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Memcached", "snippet": "Memcached\nКласс подключения — `\\Bitrix\\Main\\Data\\MemcachedConnection`.\n\n- `host` — хост сервера. По умолчанию имеет значение `localhost`.\n\n- `port` — порт сервера. По умолчанию имеет значение `11211`.\n\n- `persistent` — использовать посто", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Redis", "snippet": "Redis\nКласс подключения — `\\Bitrix\\Main\\Data\\RedisConnection`.\n\n- `host` — хост сервера. По умолчанию имеет значение `localhost`.\n\n- `port` — порт сервера. По умолчанию имеет значение `6379`.\n\n- `password` — пароль для аутентификации. До", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "HandlerSocket", "snippet": "HandlerSocket\nHandlerSocket — это плагин для MySQL, который работает без SQL-запросов. Он снижает нагрузку на сервер и ускоряет обработку данных.\n\nДобавьте указание на HandlerSocket в основное соединение:\n\n```php\n'default' => [\n 'classNa", "page": "docs-database-configuration", "path": "/docs/database/configuration/", "title": "Конфигурация"}, {"heading": "Выполнение запросов", "snippet": "Выполнение запросов\nДля начала работы с базой данных получите объект соединения:\n\n```php\n/** @var \\Bitrix\\Main\\DB\\Connection $db */\n$db = \\Bitrix\\Main\\Application::getConnection();\n```", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Как выполнять SELECT-запросы", "snippet": "Как выполнять SELECT-запросы\nСделать базовый запрос:\n\n```php\n$result = $db->query('SELECT `ID`, `NAME` FROM b_user');\n```\n\nОграничить количество результатов:\n\n```php\n// Вернет первые 10 записей\n$result = $db->query('SELECT `ID`, `NAME` FROM", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Как выполнять INSERT-запросы", "snippet": "Как выполнять INSERT-запросы\nДобавить одну запись:\n\n```php\n$id = $db->add('my_table', [\n 'NAME' => 'example',\n 'CONTENT' => 'Про \"базы\" данных'\n]);\n// SQL: INSERT INTO `my_table`(`NAME`, `CONTENT`) VALUES ('example', 'про \\\" базы \\'')", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Создать новую таблицу", "snippet": "Создать новую таблицу\nСоздает новую таблицу метод `createTable`. Параметры метода:\n\n- `$tableName` — имя создаваемой таблицы,\n\n- `$arFields` — массив полей таблицы в формате `'FIELD_NAME' => FieldObject`.\n\n```php\n$db->createTable('my_tabl", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Создать индекс", "snippet": "Создать индекс\nСоздает индекс метод `createIndex`. Параметры метода:\n\n- `$indexName` — имя создаваемого индекса,\n\n- `$tableName` — имя таблицы,\n\n- `$columns` — массив имен столбцов для индекса,\n\n- `$unique` — флаг уникальности индекса, ", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Проверить существование таблицы", "snippet": "Проверить существование таблицы\nПроверяет существование таблицы метод `isTableExists`. Метод возвращает `true` если таблица существует, `false` если нет.\n\n```php\n$db->isTableExists('my_table');\n```\n\nВернуть описание полей таблицы\nВозвращает", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Разница между `fetch()` и `fetchRaw()`", "snippet": "Разница между `fetch()` и `fetchRaw()`\n- `fetch()` — автоматически преобразует данные согласно настройкам системы.\n\n- `fetchRaw()` — возвращает данные в оригинальном формате.\n\n```php\n// fetch() — с преобразованием типов\n$row = $result->fe", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Конвертеры и модификаторы данных", "snippet": "Конвертеры и модификаторы данных\nДобавляйте свои конвертеры столбцов и модификаторы выборки, чтобы преобразовывать данные перед использованием.\n\n**Конвертер столбца**. Преобразует значение одного столбца. Это полезно, если нужно изменить фо", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Дополнительные методы", "snippet": "Дополнительные методы\n```php\n// Количество выбранных строк\n$count = $result->getSelectedRowsCount();\n\n// Объект драйвера БД. Например, для MySQL это экземпляр класса mysqli_result\n$resource = $result->getResource();\n\n// Список полей в резул", "page": "docs-database-query-execution", "path": "/docs/database/query-execution/", "title": "Выполнение запросов"}, {"heading": "Формирование запросов", "snippet": "Формирование запросов\nВ Bitrix Framework есть два инструмента для работы с SQL-запросами.\n\n**SqlHelper.** Отвечает за экранирование данных и форматирование SQL-выражений.\n\n**SqlExpression.** Позволяет строить безопасные запросы через плейсх", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Как конвертировать данные для SQL", "snippet": "Как конвертировать данные для SQL\nОбщий метод `convertToDb` обрамляет строки в кавычки, `NULL` преобразует в `'NULL'`:\n\n```php\n$helper->convertToDb('не \" безопасная \\' строка'); // 'не \\\" безопасная \\' строка'\n$helper->convertToDb(null); //", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Как конвертировать данные для работы с БД", "snippet": "Как конвертировать данные для работы с БД\nКонвертировать бинарные данные:\n\n```php\n$binaryData = base64_decode('iVBORw0KGgoAAA==');\n$helper->convertToDbBinary($binaryData); // 'PNG\\r\\n\\Z\\n\\0\\0'\n```\n\nКонвертировать в целое число:\n\n```php\n$hel", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Как выполнять операции с датами и временем", "snippet": "Как выполнять операции с датами и временем\nКонвертировать дату:\n\n```php\n$helper->convertToDbDate(new \\Bitrix\\Main\\Type\\Date('01.01.2015')); // '2015-01-01'\n```\n\nКонвертировать время:\n\n```php\n$helper->convertToDbDateTime(new \\Bitrix\\Main\\Typ", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Как работать с SQL-функциями", "snippet": "Как работать с SQL-функциями\nПолучить текущую дату или время:\n\n```php\n$helper->getCurrentDateFunction(); // CURDATE()\n$helper->getCurrentDateTimeFunction(); // NOW()\n```\n\nПреобразовать дату и время в дату:\n\n```php\n$helper->getDatetimeT", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Как совершать пакетные операции с данными", "snippet": "Как совершать пакетные операции с данными\n`prepareMerge()` — добавляет или обновляет одну запись:\n\n```php\n[ $sql ] = $helper->prepareMerge(\n tableName: 'b_user_counter',\n primaryFields: ['USER_ID', 'SITE_ID', 'CODE'],\n insertFields", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "SqlExpression. Безопасное построение запросов", "snippet": "SqlExpression. Безопасное построение запросов\nSqlExpression использует специальные метки — плейсхолдеры. При компиляции запроса плейсхолдеры заменяются на экранированные значения для предотвращения SQL-инъекций.\n\n- `?` — автоматическое пре", "page": "docs-database-sql-helper-and-expression", "path": "/docs/database/sql-helper-and-expression/", "title": "Формирование запросов"}, {"heading": "Построитель запросов", "snippet": "Построитель запросов\nВ Bitrix Framework нет абстрактного построителя для выполнения произвольных запросов к произвольным таблицам. Используйте вместо этого построитель запросов для конкретных таблиц, привязанных к ORM.\n\n!!! tip \"Подробнее в", "page": "docs-database-query-builder", "path": "/docs/database/query-builder/", "title": "Построитель запросов"}, {"heading": "Отладка запросов", "snippet": "Отладка запросов\nКласс `Bitrix\\Main\\Diag\\SqlTracker` используется для отладки и анализа SQL-запросов:\n\n- замеряет время выполнения,\n\n- собирает стек вызовов,\n\n- сохраняет параметры запросов `binds`.\n\nЗапустить трекинг\nМетод `startTracker", "page": "docs-database-sql-tracker", "path": "/docs/database/sql-tracker/", "title": "Отладка запросов"}, {"heading": "Получить результат", "snippet": "Получить результат\n```php\nforeach ($tracker->getQueries() as $query)\n{\n print_r([\n $query->getSql(), // текст запроса\n $query->getTime(), // время в секундах\n $query->getTrace(), // стек вызовов\n $q", "page": "docs-database-sql-tracker", "path": "/docs/database/sql-tracker/", "title": "Отладка запросов"}, {"heading": "Записать лог трекера в файл", "snippet": "Записать лог трекера в файл\nЗаписывать лог можно с помощью методов `startFileLog` и `stopFileLog`.\n\n```php\n// Запускаем трекинг\n$tracker = \\Bitrix\\Main\\Application::getConnection()->startTracker(true);\n\n// Указываем путь к файлу лога\n$logPa", "page": "docs-database-sql-tracker", "path": "/docs/database/sql-tracker/", "title": "Отладка запросов"}, {"heading": "Транзакции", "snippet": "Транзакции\nТранзакция — это набор операций с базой данных, которые выполняются как единое целое: либо выполняются все операции, либо не выполняется ни одной. Это гарантирует целостность данных, даже если несколько процессов работают с базой", "page": "docs-database-transactions", "path": "/docs/database/transactions/", "title": "Транзакции"}, {"heading": "Как работать с транзакциями", "snippet": "Как работать с транзакциями\n!!! warning \"Внимание\"\n\n\n Делайте транзакции короткими. Долгие транзакции увеличивают риск взаимных блокировок, каскадных откатов и аварийного завершения операций.\n\n\n\nИспользуйте объект [`Bitrix\\Main\\DB\\Connec", "page": "docs-database-transactions", "path": "/docs/database/transactions/", "title": "Транзакции"}, {"heading": "Особенности вложенных транзакций", "snippet": "Особенности вложенных транзакций\nМожно вызывать транзакции внутри других транзакций. В этом случае:\n\n- `startTransaction()` внутри другой транзакции создает точку сохранения — `SAVEPOINT`,\n\n- `commitTransaction()` во вложенной транзакции ", "page": "docs-database-transactions", "path": "/docs/database/transactions/", "title": "Транзакции"}, {"heading": "Как обрабатывать ошибки во вложенных транзакциях", "snippet": "Как обрабатывать ошибки во вложенных транзакциях\nЕсли вложенная транзакция завершилась с ошибкой:\n\n1. откатите основную транзакцию полностью — `rollbackTransaction`,\n\n2. решите, как следует обработать ошибку — залогировать, повторить операц", "page": "docs-database-transactions", "path": "/docs/database/transactions/", "title": "Транзакции"}, {"heading": "NoSQL", "snippet": "NoSQL\nВ рамках NoSQL-подхода Bitrix Framework поддерживает работу с key-value хранилищами:\n\n- Redis — для кеширования, управления сессиями и обработки очередей задач,\n\n- Memcached — только для кеширования данных.\n\nНастройка Redis\n1. Устан", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Особенности Redis cluster", "snippet": "Особенности Redis cluster\nRedis поддерживает два подхода к организации кластера.\n\n- **Мультимастерная конфигурация — Multi-Master**. Несколько серверов Redis работают как равноправные мастер-узлы и могут принимать запись. Каждый мастер-узе", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Как настроить Redis cluster в режиме Multi-Master", "snippet": "Как настроить Redis cluster в режиме Multi-Master\n1. Укажите все мастер-узлы в массиве `servers`.\n\n2. Задайте параметры кластера.\n\n```php\n// bitrix/.settings.php\nreturn [\n // ...\n 'session' => [\n 'value' => [\n 'mode'", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Как настроить Redis cluster в режиме Master-Slave", "snippet": "Как настроить Redis cluster в режиме Master-Slave\n1. Укажите основной сервер, который будет обрабатывать записи.\n\n2. Redis обнаружит и задействует подключенные слейвы без дополнительных настроек.\n\n```php\nreturn [\n 'session' => [\n ", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Как получить и использовать соединение с Redis", "snippet": "Как получить и использовать соединение с Redis\nBitrix Framework предоставляет два способа взаимодействия с Redis:\n\n```php\n/**\n * @var \\Bitrix\\Main\\Data\\RedisConnection $connection\n */\n$connection = \\Bitrix\\Main\\Application::getConnection('m", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Настройка Memcached", "snippet": "Настройка Memcached\n1. Установите расширение Memcached для PHP.\n\n2. Откройте файл `/bitrix/.settings.php`.\n\n3. Добавьте новое подключение в секцию `connections`:\n\n```php\n'connections' => [\n 'value' => [\n 'default' => [\n ", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Особенности Memcached cluster", "snippet": "Особенности Memcached cluster\nЧтобы распределить нагрузку между несколькими серверами Memcached, укажите их в параметре `servers`. Чем больше `weight` сервера, тем больше запросов он будет получать. Для равномерного распределения задайте од", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "Как получить и использовать соединение с Memcached", "snippet": "Как получить и использовать соединение с Memcached\nBitrix Framework предлагает два подхода для работы с Memcached:\n\n```php\n/**\n * @var \\Bitrix\\Main\\Data\\MemcachedConnection $connection\n */\n$connection = \\Bitrix\\Main\\Application::getConnecti", "page": "docs-database-nosql", "path": "/docs/database/nosql/", "title": "NoSQL"}, {"heading": "HandlerSocket", "snippet": "HandlerSocket\nHandlerSocket — это протокол доступа к данным MySQL. Он позволяет пропускать стандартные этапы обработки SQL-запросов, чтобы быстрее получать данные.\n\n!!! warning \"Внимание\"\n\n\n HandlerSocket ускоряет только SELECT-запросы. ", "page": "docs-database-handlersocket", "path": "/docs/database/handlersocket/", "title": "HandlerSocket"}, {"heading": "Как установить HandlerSocket", "snippet": "Как установить HandlerSocket\n- **Cоберите плагин из исходников MySQL.** Этот способ подходит, если нужно добавить HandlerSocket к существующей MySQL.\n\n- **Используйте MariaDB.** Это форк MySQL, в котором HandlerSocket включен по умолчанию", "page": "docs-database-handlersocket", "path": "/docs/database/handlersocket/", "title": "HandlerSocket"}, {"heading": "Как подключить HandlerSocket", "snippet": "Как подключить HandlerSocket\nДобавьте указание на HandlerSocket в конфигурационный файл `/bitrix/.settings.php` под ключом `'default'`:\n\n```php\n'default' => [\n 'className' => \\Bitrix\\Main\\DB\\MysqliConnection::class,\n 'handlersocket' =", "page": "docs-database-handlersocket", "path": "/docs/database/handlersocket/", "title": "HandlerSocket"}, {"heading": "Пример конфигурации с HandlerSocket", "snippet": "Пример конфигурации с HandlerSocket\nЭтот конфигурационный файл позволяет настроить два типа подключений к БД — обычное через MySQL и быстрое через HandlerSocket:\n\n```php\n'connections' => [\n 'value' => [\n // Основное соединение с M", "page": "docs-database-handlersocket", "path": "/docs/database/handlersocket/", "title": "HandlerSocket"}, {"heading": "Как перейти с MySQL на PostgreSQL", "snippet": "Как перейти с MySQL на PostgreSQL\nПеред переносом данных из MySQL в [PostgreSQL](https://postgrespro.ru) подготовьте окружение, проверьте ограничения и выберите способ миграции: через мастер или командную строку.\n\nPostgreSQL поддерживается ", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Другие операционные системы", "snippet": "Другие операционные системы\nИнструкции по установке и настройке PostgreSQL для Debian, Альт СП, Альт и РОСА доступны в главе [Установка БУС/КП на другие окружения](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=135&CHAPTER_ID=", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Как выполнить миграцию", "snippet": "Как выполнить миграцию\n- Перед началом убедитесь, что срок действия вашей текущей лицензии покрывает период тестирования (до 6 месяцев) и момент финального перехода. Если лицензия истекает раньше, продлите ее до начала работ.\n- Перейдите на", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Важно учитывать", "snippet": "Важно учитывать\n- Вернуться на MySQL после миграции, тестирования и запуска PostgreSQL в рабочем контуре можно только вручную.\n- Если на проекте используются модули из маркетплейса, [проверьте их совместимость](./compatible-code.md) с новой", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Порядок действий для миграции", "snippet": "Порядок действий для миграции\n1. Проверьте перенос на тестовом контуре:\n - сделайте [резервную копию](../../advanced/backup.md) проекта,\n - [разверните](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=135&CHAPTER_ID=02014) ", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Миграция через мастер", "snippet": "Миграция через мастер\nПерейдите в административный раздел *Рабочий стол > Настройки > Настройки продукта > Список мастеров* и запустите мастер *Миграция в PostgreSQL* `bitrix:perfon.pgsql`. Начнется пошаговый процесс миграции.\n\n1. Сначала м", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Миграция через командную строку", "snippet": "Миграция через командную строку\n1. Создайте пользователя и базу PostgreSQL.\n\n ```bash prompt=\"$\"\n $ sudo -u postgres createuser bitrix\n $ sudo -u postgres psql -c 'grant create on schema public to \"bitrix\"'\n GRANT\n $ sudo -u postg", "page": "docs-database-postgresql-migration", "path": "/docs/database/postgresql/migration/", "title": "Как перейти с MySQL на PostgreSQL"}, {"heading": "Поддержка PostgreSQL в модулях", "snippet": "Поддержка PostgreSQL в модулях\nПеред миграцией на PostgreSQL проверьте поддержку модулей Bitrix Framework и версии модулей в дистрибутивах для PostgreSQL. Таблицы помогут определить модули, которые нужно обновить, проверить или отключить.", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Поддержка модулей в PostgreSQL", "snippet": "Поддержка модулей в PostgreSQL\nТаблица показывает, какие модули поддерживают PostgreSQL и с какой версии доступна поддержка.\n\n| Модуль | Поддержка | С версии |\n| --- | --- | --- |\n| Главный модуль (main) | Да | 23.900.900 |\n| AI интеграция ", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Модули в дистрибутиве Битрикс24", "snippet": "Модули в дистрибутиве Битрикс24\nВ таблице указаны версии модулей в составе дистрибутива лицензии Битрикс24 [Энтерпрайз для Постгрес](https://www.1c-bitrix.ru/buy/products/b24.php).\n\n| Модуль | Версия |\n| --- | --- |\n| AD/LDAP интеграция (ld", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Модули в дистрибутиве *1С-Битрикс: Управление сайтом*", "snippet": "Модули в дистрибутиве *1С-Битрикс: Управление сайтом*\nВ таблице указаны версии модулей в составе дистрибутива лицензии *1С-Битрикс: Управление сайтом* [Энтерпрайз для Постгрес](https://www.1c-bitrix.ru/buy/products/cms.php).\n\n| Модуль | Вер", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Модули Битрикс24 в MySQL и PostgreSQL", "snippet": "Модули Битрикс24 в MySQL и PostgreSQL\nТаблица сравнивает наличие модулей лицензии Битрикс24 «Энтерпрайз» для MySQL и PostgreSQL. Значение «Нет» означает, что модуль не входит дистрибутив.\n\n| Модуль | MySQL | PostgreSQL |\n| --- | --- | --- |", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Модули *1С-Битрикс: Управление сайтом* в MySQL и PostgreSQL", "snippet": "Модули *1С-Битрикс: Управление сайтом* в MySQL и PostgreSQL\nТаблица сравнивает наличие модулей лицензии 1С-Битрикс: Управление сайтом «Энтерпрайз» для MySQL и PostgreSQL. Значение «Нет» означает, что модуль не входит в соответствующий вариа", "page": "docs-database-postgresql-module-support", "path": "/docs/database/postgresql/module-support/", "title": "Поддержка PostgreSQL в модулях"}, {"heading": "Как писать код, совместимый с PostgreSQL", "snippet": "Как писать код, совместимый с PostgreSQL\nПеред миграцией на PostgreSQL проверьте сторонние модули и доработки проекта. Найдите прямые SQL-запросы, замените специфичные функции MySQL и используйте совместимые методы Bitrix Framework.\n\n!!! wa", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Схема данных", "snippet": "Схема данных\nДля квотирования идентификаторов в PostgreSQL используются двойные кавычки.\n\nPostgreSQL преобразует все неквотированные идентификаторы к нижнему регистру и ищет их в метаданных базы.\n\nДля совместимости с кодом *1С-Битрикс: Упра", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Типы колонок", "snippet": "Типы колонок\nЗамените типы колонок, которые могут работать по-разному в MySQL и PostgreSQL:\n\n- `timestamp` — на `datetime` с переносом логики на PHP;\n- `enum` — на `char`, чтобы PostgreSQL не создавал отдельный тип для колонки;\n- `char` — н", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Имена индексов", "snippet": "Имена индексов\nВ MySQL имена индексов локальны по отношению к таблице, поэтому разные индексы у разных таблиц могут называться одинаково.\n\n```sql\nCREATE TABLE author (id int, name varchar(50), primary key (id), key ix_search(name));\nCREATE ", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Использование специфичного квотирования", "snippet": "Использование специфичного квотирования\nИспользование обратных кавычек для экранирования идентификаторов в MySQL не подходит для PostgreSQL.\n\nТакие конструкции нужно переписать с использованием методов `CDatabase::quote` или `SqlHelper::quo", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Функции", "snippet": "Функции\nЗамените функции MySQL на стандартные SQL-конструкции или методы Bitrix Framework. Если функция используется в прямом SQL-запросе, перепишите запрос перед миграцией.\n\nifnull()\nЗамените `ifnull()` на `coalesce()`.\n\nБыло:\n\n```sql\nSELE", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "get_lock() и release_lock()", "snippet": "get_lock() и release_lock()\nПерепишите прямые запросы на методы `DatabaseConnection`.\n\n```php\n$lockName = 'mylock';\n$connection = \\Bitrix\\Main\\Application::getConnection();\nif ($connection->lock($lockName))\n{\n // ...\n $connection->unl", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "date()", "snippet": "date()\nПерепишите с использованием метода `getCurrentDateFunction` из `\\Bitrix\\Main\\Application::getConnection()->getSqlHelper()`.\n\nrand()\nПерепишите с использованием метода `getRandomFunction` из `\\Bitrix\\Main\\Application::getConnection()-", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Запросы", "snippet": "Запросы\n`INSERT IGNORE`\n\nПерепишите прямые запросы на методы [SqlHelper](../sql-helper-and-expression.md).\n\n```php\n$sql = 'INSERT IGNORE INTO b_user_group (USER_ID, GROUP_ID, DATE_ACTIVE_FROM, DATE_ACTIVE_TO) VALUES (...)';\n$sql = 'INSERT I", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Использование классов", "snippet": "Использование классов\n- `MysqlCommonConnection`\n- `MssqlConnection`\n- `OracleConnection`\n\nПроверьте код, который использует эти классы.\n\nНекоторые особенности\n`CDatabase::Add` в таблицу без автоинкремента:\n\n```php\n$DB->Add(\"b_iblock_fields\"", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Различия в CDatabase::PrepareInsert и SqlHelper::prepareInsert {#CDatabase}", "snippet": "Различия в CDatabase::PrepareInsert и SqlHelper::prepareInsert {#CDatabase}\n- Поля типа дата/время обрабатываются по-разному.\n- `CDatabase` учитывает настройку часовых поясов, а `SqlHelper` — нет.\n\nПоэтому в методы хелпера передавайте объек", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Использование двойных кавычек", "snippet": "Использование двойных кавычек\nВ PostgreSQL нельзя использовать двойные кавычки для строковых литералов. Заменяйте их на одиночные кавычки.", "page": "docs-database-postgresql-compatible-code", "path": "/docs/database/postgresql/compatible-code/", "title": "Как писать код, совместимый с PostgreSQL"}, {"heading": "Установка PostgreSQL на macOS", "snippet": "Установка PostgreSQL на macOS\nPostgreSQL на macOS можно установить через Homebrew для локального окружения или тестового контура перед миграцией проекта с MySQL на PostgreSQL.\n\nУстановка на macOS\nПеред установкой проверьте, что Homebrew уст", "page": "docs-database-postgresql-installation-macos", "path": "/docs/database/postgresql/installation-macos/", "title": "Установка PostgreSQL на macOS"}, {"heading": "Конфигурация PostgreSQL", "snippet": "Конфигурация PostgreSQL\nВ примерах используется пользователь `www-data`, база данных `www-data` и пароль `passwd`. Замените эти значения на параметры вашего проекта.\n\n1. Добавьте пользователя.\n\n ```bash prompt=\"$\"\n $ createuser www-data", "page": "docs-database-postgresql-installation-macos", "path": "/docs/database/postgresql/installation-macos/", "title": "Установка PostgreSQL на macOS"}, {"heading": "Концепция ORM", "snippet": "Концепция ORM\nORM (Object-Relational Mapping) — это технология, которая позволяет работать с базой данных через объекты в коде вместо написания SQL-запросов вручную. Это упрощает взаимодействие с данными и делает код более читаемым и поддер", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Концепция сущностей", "snippet": "Концепция сущностей\nСущность — это таблица в базе данных. Каждая сущность состоит из полей, которые соответствуют колонкам таблицы. Например, сущность «Пользователь» может включать поля: ID, Имя, Фамилия, Пароль, Логин.\n\nВместо программиров", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Типизация полей", "snippet": "Типизация полей\nДля описания сущностей используется PHP. Это обеспечивает гибкость и позволяет использовать возможности языка для настройки сущностей.\n\nПример определения типов данных:\n\n```php\nnamespace SomePartner\\MyBooksCatalog;\n\nuse Bitr", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Типы полей", "snippet": "Типы полей\n- `IntegerField` — поле для хранения целых чисел.\n\n Конструктор:\n\n ```php\n new Entity\\IntegerField('NAME', [\n 'size' => 32, // Размер поля в битах (необязательный параметр)\n ]);\n ```\n\n Методы настройки:\n\n `co", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Первичный ключ, обязательные поля и NULL значения", "snippet": "Первичный ключ, обязательные поля и NULL значения\nПервичный ключ (Primary Key) — это уникальный идентификатор записи в таблице. Обычно это поле с автоинкрементом, которое автоматически увеличивается при добавлении новой записи.\n\nВ большинст", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Значения по умолчанию", "snippet": "Значения по умолчанию\nДля полей сущностей можно задать значения по умолчанию. Они применяются, если значение для этих полей не указано при добавлении новой записи. Для этого используется параметр `default_value`.\n\nПараметр `default_value` м", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Пример установки значения по умолчанию", "snippet": "Пример установки значения по умолчанию\nРассмотрим пример с каталогом книг, где в поле Дата публикации по умолчанию устанавливается текущий день.\n\n```php\nnew Entity\\DateField('PUBLISH_DATE', [\n 'default_value' => new Type\\Date() // Устана", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Маппинг имени колонки", "snippet": "Маппинг имени колонки\nЕсли вы хотите изменить название колонки в таблице, используйте параметр `column_name`. Например, в таблице `my_book` поле ISBN изначально называлось ISBNCODE, и старый код использует это название в SQL-запросах. Чтобы", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Выражения ExpressionField", "snippet": "Выражения ExpressionField\nДанные можно не только хранить, но и преобразовывать при выборке. Например, чтобы вместе с датой издания получать возраст книги в днях, не нужно хранить это число в БД и обновлять его ежедневно. Можно вычислить воз", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Пользовательские поля", "snippet": "Пользовательские поля\nПользовательские поля настраиваются через административный интерфейс и не требуют описания в сущности. Для их использования нужно указать идентификатор сущности.\n\n```php\nclass BookTable extends Entity\\DataManager\n{\n ", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Валидаторы", "snippet": "Валидаторы\nВалидаторы используются для проверки данных перед их записью в базу данных. Они помогают убедиться, что данные соответствуют правилам и форматам.\n\nВалидация задается параметром `validation` в конструкторе поля и представляет собо", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Стандартные валидаторы", "snippet": "Стандартные валидаторы\nВалидаторы работают при добавлении и обновлении записей. Для проверки данных только при добавлении или обновлении используйте механизм событий.\n\nРекомендуем использовать стандартные валидаторы:\n\n- **BooleanValidator*", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Пример использования валидаторов", "snippet": "Пример использования валидаторов\nРассмотрим пример использования валидаторов для проверки поля ISBN в каталоге книг. ISBN — это уникальный идентификатор книги. Сделаем поле ISBN обязательным и зададим шаблон проверки: код поля должен состоя", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Коды ошибок", "snippet": "Коды ошибок\nЕсли у поля несколько валидаторов и нужно узнать, какой из них сработал, можно использовать код ошибки. По умолчанию есть два стандартных кода ошибок:\n\n- `BX_INVALID_VALUE` — если сработал валидатор,\n\n- `BX_EMPTY_REQUIRED` — е", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Кеширование", "snippet": "Кеширование\nКеширование ускоряет работу с данными, но в некоторых случаях его нужно отключать. Например, если данные часто изменяются.\n\n!!! note \"Примечание\"\n\n\n С версии 24.100.0 Главного модуля появилась возможность отключать кешировани", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Пример создания сущности", "snippet": "Пример создания сущности\n```php\nnamespace SomePartner\\MyBooksCatalog; // Определить пространство имен для организации кода\n\nuse Bitrix\\Main\\Entity; // Подключить класс Entity из Bitrix для работы с сущностями\n\n// Определить класс BookTable,", "page": "docs-orm-orm-concepts", "path": "/docs/orm/orm-concepts/", "title": "Концепция ORM"}, {"heading": "Операции с сущностями и события", "snippet": "Операции с сущностями и события\nСущности позволяют взаимодействовать с базой данных, выполняя основные операции: добавление, изменение и удаление записи. Этот подход упрощает работу с данными и обеспечивает их целостность и безопасность.\n\nО", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Метод add", "snippet": "Метод add\nМетод добавляет запись, принимая массив значений. Ключами массива являются имена полей сущности.\n\n```php\nnamespace SomePartner\\MyBooksCatalog; // Пространство имен, в котором находится код\n\nuse Bitrix\\Main\\Type; // Подключаем клас", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Метод update", "snippet": "Метод update\nМетод обновляет запись, добавляя к массиву значений первичный ключ.\n\n```php\n$result = BookTable::update($id, [\n 'PUBLISH_DATE' => new Type\\Date('2002-11-15', 'Y-m-d') // Изменить дату\n]);\n```\n\nМетод `update` в качестве резул", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "События {#events}", "snippet": "События {#events}\nЧтобы хранить в БД только важные данные, используйте обработчик события.\n\nДоступные события:\n\n#|\n|| **Событие** | **Когда срабатывает** | **Описание параметров** ||\n|| **OnBeforeAdd** | Перед добавлением новой записи в баз", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Как изменить данные с помощью события", "snippet": "Как изменить данные с помощью события\nСистема распознает метод `onBeforeAdd` как обработчик события «перед добавлением». В нем можно изменить данные или провести дополнительные проверки.\n\nВ примере с валидаторами для поля ISBN проверяли нал", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Как запретить обновление данных", "snippet": "Как запретить обновление данных\nВ обработчике события можно удалять данные или прерывать операцию. Например, чтобы запретить обновление ISBN для созданных книг, используйте событие `onBeforeUpdate` одним из способов:\n\n- Удалите ISBN из дан", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Форматирование значений", "snippet": "Форматирование значений\nИногда нужно хранить данные в одном формате, а работать с ними — в другом. Часто это касается массивов, которые сериализуются перед сохранением в БД, то есть преобразуются в строку. Для этого есть параметры поля `sav", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Вычисляемые значения", "snippet": "Вычисляемые значения\nВычисляемые значения в базе данных помогают поддерживать целостность данных, выполняя расчеты на стороне сервера. Это избавляет от необходимости каждый раз получать старое значение и пересчитывать его в приложении.\n\nДля", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Пример использования вычисляемых значений", "snippet": "Пример использования вычисляемых значений\nЧтобы увеличить количество читателей `READERS_COUNT` на 1, можно обновить соответствующее поле в базе данных.\n\n```php\nBookTable::update($id, [ // Обновление записи в таблице BookTable\n 'READERS_C", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Предупреждения об ошибках", "snippet": "Предупреждения об ошибках\nВызывать методы можно как с проверкой успешности выполнения запроса, так и без проверки.\n\nВ режиме агента рекомендуем проверять результат выполнения операций с помощью `$result->isSuccess()` и логировать ошибки. Ес", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Пример создания сущности", "snippet": "Пример создания сущности\nСоздадим класс `BookTable`, который представляет таблицу для хранения информации о книгах. В классе зададим поля таблицы, их типы и правила валидации. С помощью событий настроим обработку данных перед их добавлением", "page": "docs-orm-entity-operations", "path": "/docs/orm/entity-operations/", "title": "Операции с сущностями и события"}, {"heading": "Объекты", "snippet": "Объекты\nВ Bitrix Framework объект представляет собой экземпляр класса. Класс соответствует записи в базе данных. Это позволяет работать с данными в виде объектов, а не массивов, что делает код более удобным.\n\nЧтобы использовать объекты, нео", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Класс объекта", "snippet": "Класс объекта\nКаждый объект сущности наследует класс `Bitrix\\Main\\ORM\\Objectify\\EntityObject`. Это означает, что у каждой сущности есть свой класс объектов, который создается автоматически.\n\nДля объекта сущности `Book` создается класс `EO_B", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Как создать свой класс", "snippet": "Как создать свой класс\nЕсли необходимо использовать собственное имя класса или добавить дополнительный функционал, можно создать свой класс объекта.\n\n```php\n// Файл bitrix/modules/main/lib/test/typography/book.php\nnamespace Bitrix\\Main\\Test", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Рекомендации", "snippet": "Рекомендации\n- Чтобы использовать конкретное имя или расширить функционал, нужно определить собственный класс объектов.\n\n- Стандартные имена классов, такие как `instanceof EO_Book`, `new EO_Book` или `EO_Book::class`, не следует использов", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Универсальные методы", "snippet": "Универсальные методы\nСуществуют универсальные методы: `getTitle`, `setTitle`, `remindActualTitle` и другие. Они принимают имя поля, например, `$fieldName`, как аргумент.\n\n```php\n$fieldName = 'TITLE';\n$book->get($fieldName);\n$book->set($fiel", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Магические методы", "snippet": "Магические методы\nИменованные методы реализованы с помощью магического метода `__call`. Это позволяет автоматически обрабатывать все поля без ручного описания. Такой подход экономит память и устраняет необходимость кеширования сгенерированн", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Приведение типов", "snippet": "Приведение типов\nВ объектах значения строго приводятся к типу поля. Это значит, что числа всегда остаются числами, а строки — строками.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\nvar_dump($", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "require", "snippet": "require\nМетод можно использовать, если поле должно быть заполнено. Если поле пустое, сценарий не будет выполнен, и будет выведена ошибка.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\n$title =", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "remindActual", "snippet": "remindActual\nМетод позволяет отличить оригинальное значение от измененного, но еще не сохраненного.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\necho $book->getTitle(); // \"Title 1\"\n$book->se", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "collectValues", "snippet": "collectValues\nМетод `collectValues` возвращает все значения объекта в виде массива.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\n$values = $book->collectValues();\n```\n\nМожно использовать филь", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "runtime", "snippet": "runtime\nДля `runtime` полей используется только универсальный метод `get`.\n\n```php\n$author = \\Bitrix\\Main\\Test\\Typography\\AuthorTable::query()\n ->registerRuntimeField(\n new \\Bitrix\\Main\\Entity\\ExpressionField(\n 'FULL_NA", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "set", "snippet": "set\nМетод `set` устанавливает новое значение для поля.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\n$book->setTitle(\"New title\");\n```\n\nОбъект запоминает исходные значения.\n\n```php\n$book->getT", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "unset", "snippet": "unset\nМетод `unset` удаляет значение объекта, как будто оно не выбиралось и не устанавливалось.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\necho $book->getTitle(); // \"Title 1\"\n$book->unsetT", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "isChanged", "snippet": "isChanged\nМетод `isChanged` определяет, было ли установлено новое значение в течение сеанса.\n\n```php\nuse Bitrix\\Main\\Test\\Typography\\Book;\n// объект может иметь исходное значение, а может и не иметь\n// это не повлияет на дальнейшее поведени", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Проверить состояние объекта", "snippet": "Проверить состояние объекта\nОбъект может находиться в одном из трех состояний:\n\n- `RAW` — новый. Объект только что создан, и его данные еще не были сохранены в базе данных.\n\n- `ACTUAL` — актуальный. Данные объекта совпадают с теми, что хр", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Сохранить объект", "snippet": "Сохранить объект\nДля сохранения изменений объекта в базе данных используется метод `save`. Этот метод фиксирует все изменения в объекте, и обновляет данные в базе данных.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Как создать новый объект", "snippet": "Как создать новый объект\nЕсть два способа создания новых объектов.\n\n1. Прямое создание объекта.\n\n ```php\n $newBook = new \\Bitrix\\Main\\Test\\Typography\\Book;\n $newBook->setTitle('New title');\n $newBook->save();\n\n $newAuthor = new \\B", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Удалить объект", "snippet": "Удалить объект\nМетод `delete()` удаляет объект из базы данных.\n\n```php\n// Удаление записи\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\n$book->delete();\n\n// Удаление по primary ключу\n$book = \\Bitrix\\M", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Восстановить объект", "snippet": "Восстановить объект\nМетод `wakeUp` восстанавливает объект из имеющихся данных без повторного запроса к базе. Это удобно, когда есть данные записи, и нужно создать объект на их основе.\n\nОбъект можно восстановить с помощью значения первичног", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Заполнить объект", "snippet": "Заполнить объект\nЧтобы дозаполнить объект с неполными данными, нужно использовать именованный метод `fill`.\n\n```php\n// Изначально у нас есть только ID и NAME\n$author = \\Bitrix\\Main\\Test\\Typography\\EO_Author::wakeUp(\n ['ID' => 17, 'NAME'", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Как управлять отношениями", "snippet": "Как управлять отношениями\nДля управления связями между объектами используются специальные методы. Эти методы позволяют добавлять, удалять и очищать связи между объектами, такими как книги и издатели.\n\nДля работы с отношениями предназначены ", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "removeFrom", "snippet": "removeFrom\nМетод `removeFrom` удаляет конкретную связь между объектами. Например, можно удалить книгу из списка книг издателя.\n\n```php\n// Инициализация издателя\n$publisher = \\Bitrix\\Main\\Test\\Typography\\PublisherTable::getByPrimary(253)\n ", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "removeAll", "snippet": "removeAll\nМетод `removeAll` удаляет все связи для указанного поля. Например, можно удалить все книги, связанные с издателем.\n\n```php\n// Инициализация издателя\n$publisher = \\Bitrix\\Main\\Test\\Typography\\PublisherTable::getByPrimary(253)\n -", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Интерфейс ArrayAccess", "snippet": "Интерфейс ArrayAccess\nИнтерфейс `ArrayAccess` позволяет работать с объектами так, как если бы они были массивами. Это упрощает переход от использования массивов к объектам, сохраняя привычный синтаксис.\n\nПример использования `ArrayAccess`:\n", "page": "docs-orm-objects", "path": "/docs/orm/objects/", "title": "Объекты"}, {"heading": "Коллекции", "snippet": "Коллекции\nКоллекция — специальный тип массива, который оптимизирует работу с объектами одного типа. Она позволяет выполнять групповые операции более эффективно.\n\nОсновные характеристики коллекции:\n\n1. Типизация. Коллекция содержит объекты о", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Класс коллекции", "snippet": "Класс коллекции\nУ каждой сущности есть свой класс коллекции, наследуемый от `Bitrix\\Main\\ORM\\Objectify\\Collection`. Класс создается автоматически. Для объектов `Book` он имеет название `EO_Book_Collection`, где `EO_` — это аббревиатура от `", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Доступ к элементам коллекции", "snippet": "Доступ к элементам коллекции\nКоллекции предоставляют методы, которые позволяют перебрать элементы, получить доступ к объектам и выполнить операции с ними.\n\nКак перебрать элементы коллекции\nКоллекция реализует интерфейс `\\Iterator`, что позв", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Как получить объекты коллекции", "snippet": "Как получить объекты коллекции\nОбъекты коллекции можно получить напрямую. Метод `getAll` возвращает все объекты в виде массива.\n\n```php\n$books = \\Bitrix\\Main\\Test\\Typography\\BookTable::getList()\n ->fetchCollection()\n;\n$bookObjects = $boo", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Проверить наличие объекта", "snippet": "Проверить наличие объекта\nМетод `has` позволяет проверить наличие объекта в коллекции напрямую.\n\n```php\n$book1 = \\Bitrix\\Main\\Test\\Typography\\Book::wakeUp(1);\n$book2 = \\Bitrix\\Main\\Test\\Typography\\Book::wakeUp(2);\n$books = \\Bitrix\\Main\\Test", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Как добавить объект", "snippet": "Как добавить объект\nДобавить объект в коллекцию можно с помощью метода `add` и интерфейса `ArrayAccess`. Интерфейс позволяет использовать синтаксис массива `[]`.\n\n```php\n$book1 = \\Bitrix\\Main\\Test\\Typography\\Book::wakeUp(1);\n$books = \\Bitri", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Сохранить новые объекты", "snippet": "Сохранить новые объекты\nМетод `save()` сохраняет новые объекты одним запросом к базе данных.\n\n```php\nuse Bitrix\\Main\\Test\\Typography\\Books;\nuse Bitrix\\Main\\Test\\Typography\\Book;\n\n$books = new Books;\n$books[] = (new Book)->setTitle('Title 11", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Обновить существующие объекты", "snippet": "Обновить существующие объекты\nМетод `save()` сохраняет измененные объекты одним запросом `UPDATE`.\n\n```php\nuse Bitrix\\Main\\Test\\Typography\\PublisherTable;\nuse Bitrix\\Main\\Test\\Typography\\BookTable;\n\n$books = BookTable::getList()->fetchColle", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Заполнить данные", "snippet": "Заполнить данные\nОперация `fill` заполняет данные объектов одним запросом. Метод `fill` выполняет массовое заполнение данных без валидации. Это может привести к ошибкам, если данные некорректны.\n\n```php\n$books = new \\Bitrix\\Main\\Test\\Typogr", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Обработать элементы коллекции {#walk}", "snippet": "Обработать элементы коллекции {#walk}\nМетод `walk` перебирает элементы коллекции без использования цикла `foreach`. Метод доступен с версии 26.0.0 главного модуля.\n\n```php\n$books = \\Bitrix\\Main\\Test\\Typography\\BookTable::getList()\n ->fet", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Получить коллекцию", "snippet": "Получить коллекцию\nМетод `get*Collection` возвращает уникальные объекты в виде коллекции, где `*` — имя поля в формате `camelCase` с заглавной буквы. Метод доступен только для полей отношений: `Reference`, `OneToMany`, `ManyToMany` .\n\n```ph", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Как восстановить коллекцию", "snippet": "Как восстановить коллекцию\nМетод `wakeUp` восстанавливает коллекцию объектов из имеющихся данных без повторного запроса к базе. Коллекцию можно восстановить по первичному ключу или по набору полей.\n\nПри восстановлении коллекции по набору п", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Как выполнить слияние", "snippet": "Как выполнить слияние\nМетод `merge` позволяет объединить две коллекции в одну. Слияние происходит по правилам, которые определены в `\\Bitrix\\Main\\ORM\\Objectify\\Collection::add`.\n\n```php\n$books = \\Bitrix\\Main\\Test\\Typography\\BookTable::getLi", "page": "docs-orm-collections", "path": "/docs/orm/collections/", "title": "Коллекции"}, {"heading": "Отношения между сущностями", "snippet": "Отношения между сущностями\nВ ORM отношения между сущностями описывают, как данные одной таблицы связаны с данными другой. Основные типы отношений:\n\n- 1:1, «один к одному». Каждая запись в первой таблице соответствует одной записи во второ", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "Отношение 1:N, «один ко многим»", "snippet": "Отношение 1:N, «один ко многим»\nОдна запись в таблице может соответствовать множеству записей в другой. В Bitrix Framework для описания таких связей используются специальные конструкторы:\n\n- `Reference` для связи «многие к одному»,\n\n- `On", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "Пример связи «многие к одному»", "snippet": "Пример связи «многие к одному»\nКаждая книга издается в одном издательстве, что создает отношение «N книг — 1 издательство». Для реализации этой связи необходимо:\n\n- добавить поле `PUBLISHER_ID` в таблицу книг,\n\n- создать связь между табли", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "2\\. Определить связь «многие к одному»", "snippet": "2\\. Определить связь «многие к одному»\nДля описания связи «книги — издательство» используем класс `Reference` из пространства имен `Bitrix\\Main\\ORM\\Fields\\Relations`. Этот класс позволяет связать две таблицы по определенному условию.\n\nУслов", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "3\\. Получить объект издательства через книгу", "snippet": "3\\. Получить объект издательства через книгу\nЧтобы получить объект сущности `Publisher` через объект `Book`, используем метод `getPublisher()`. Этот метод автоматически загружает связанное издательство.\n\n```php\n$book = \\Bitrix\\Main\\Test\\Typ", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "4\\. Установить связь между книгой и издательством", "snippet": "4\\. Установить связь между книгой и издательством\nЧтобы установить связь между книгой и издательством, передадим объект `Publisher` в сеттер `setPublisher()`. Значение поля `PUBLISHER_ID` заполнится автоматически.\n\n```php\n// Инициализация о", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "5\\. Результат для массивов", "snippet": "5\\. Результат для массивов\nЕсли требуется получить данные в виде массива, результат будет содержать все поля книги и связанные данные издательства.\n\n```php\n$result = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1, [\n 'select' => ", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "6\\. Как использовать алиасы для полей", "snippet": "6\\. Как использовать алиасы для полей\nПо умолчанию поля связанной сущности получают уникальные имена, основанные на пространстве имен и имени класса. Чтобы сделать имена более короткими и удобными, можно использовать алиасы. Например, вмест", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "1\\. Определить класс PublisherTable", "snippet": "1\\. Определить класс PublisherTable\nСоздадим класс `PublisherTable`, который представляет собой таблицу издательств в базе данных. Этот класс наследуется от `DataManager` — основного класса для работы с данными в Bitrix Framework.\n\n```php\nn", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "2\\. Выбрать данные через связь", "snippet": "2\\. Выбрать данные через связь\nИспользуем связь, чтобы получить данные из таблицы издательств и связанных с ними книг.\n\nМетод `getByPrimary` возвращает запись по первичному ключу — в данном случае `ID=253`.\n\nЦикл `foreach` проходит по всем", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "3\\. Получить данные в виде массива", "snippet": "3\\. Получить данные в виде массива\nЕсли запросить данные в виде массива, то результат будет содержать дублирование данных об издательстве для каждой связанной книги.\n\n```php\n$data = \\Bitrix\\Main\\Test\\Typography\\PublisherTable::getByPrimary(", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "4\\. Как добавить объект", "snippet": "4\\. Как добавить объект\nЧтобы добавить новую книгу в коллекцию книг издательства, используйте метод `addToBooks`. Этот метод добавляет существующую книгу в коллекцию. Если книги еще нет в базе данных, она должна быть создана заранее.\n\n```ph", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "5\\. Как удалить связь", "snippet": "5\\. Как удалить связь\nЧтобы удалить связь со стороны книги, используйте метод `setPublisher(null)` для разрыва связи между книгой и издательством. Это не удаляет книгу из базы данных.\n\nЧтобы удалить связь со стороны издательства, используйт", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "6\\. Как проверить заполнение поля отношений", "snippet": "6\\. Как проверить заполнение поля отношений\nЕсли вы не уверены, что поле отношений уже загружено, используйте метод `fill`.\n\n```php\n// Инициализация объекта книги\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::wakeUpObject(2);\n// Метод wak", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "Отношение 1:1, «один к одному»", "snippet": "Отношение 1:1, «один к одному»\nОтношения 1:1 работают так же, как и 1:N, но с одним отличием: в обеих сущностях вместо пары `Reference + OneToMany` используются только поля `Reference`.\n\nПример связи «один к одному»\nРассмотрим пример, где у", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "1\\. Описать сущность Book", "snippet": "1\\. Описать сущность Book\nКласс `BookTable` представляет таблицу книг в базе данных. Он содержит следующие поля:\n\n- `ID` — первичный ключ таблицы, который автоматически заполняется при создании новой записи,\n\n- `TITLE` — строка, содержаща", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "2\\. Описать сущность Cover", "snippet": "2\\. Описать сущность Cover\nКласс `CoverTable` представляет таблицу обложек в базе данных. Он содержит следующие поля:\n\n- `ID` — первичный ключ таблицы, который автоматически заполняется при создании новой записи,\n\n- `IMAGE_URL` — строка, ", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "3\\. Настроить связь «один к одному»", "snippet": "3\\. Настроить связь «один к одному»\nДля связи «один к одному» между таблицами `BookTable` и `CoverTable` используется поле `Reference`. Это поле позволяет создать связь между таблицами через указанные условия соединения.\n\n```php\nnamespace B", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "Отношение N:M, «многие ко многим»", "snippet": "Отношение N:M, «многие ко многим»\nДля описания отношения «многие ко многим» используется поле `ManyToMany`, которое автоматически создает временную сущность для работы с промежуточной таблицей. Эта сущность скрыта от пользователя, но позвол", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "1\\. Описать связь «книга — автор»", "snippet": "1\\. Описать связь «книга — автор»\nИспользуемые параметры:\n\n- `AUTHORS` — имя свойства, через которое будет осуществляться доступ к связанным авторам,\n\n- `AuthorTable::class` — класс таблицы, с которой устанавливается связь,\n\n- `configure", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "2\\. Описать связь «автор — книга»", "snippet": "2\\. Описать связь «автор — книга»\nИспользуемые параметры:\n\n- `BOOKS` — имя свойства, через которое будет осуществляться доступ к связанным книгам,\n\n- `BookTable::class` — класс таблицы, с которой устанавливается связь,\n\n- `configureTable", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "3\\. Как выглядит автоматически созданная временная сущность", "snippet": "3\\. Как выглядит автоматически созданная временная сущность\nВ памяти автоматически создается временная сущность для работы с промежуточной таблицей. Это типовая сущность с направленными отношениями 1:N к исходным сущностям-партнерам, где:\n\n", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "3\\. Как явно задать имена полей", "snippet": "3\\. Как явно задать имена полей\nЕсли необходимо явно задать имена полей или работать со сложными первичными ключами, используйте конфигурирующие методы `configure`.\n\nМетод `configureLocalPrimary` указывает, как будет называться привязка к п", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "4\\. Как работать с данными", "snippet": "4\\. Как работать с данными\nРабота с данными аналогична отношениям 1:N.\n\nДобавление связи:\n\n- `addToBooks` — добавляет книгу в коллекцию книг автора,\n\n- `save` — сохраняет изменения в базе данных.\n\n```php\n$author = \\Bitrix\\Main\\Test\\Typogr", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "5\\. Связь между объектами сущностей", "snippet": "5\\. Связь между объектами сущностей\nСвязь со стороны авторов:\n\n```php\n$author = \\Bitrix\\Main\\Test\\Typography\\AuthorTable::getByPrimary(17)\n ->fetchObject() // Получаем объект автора с ID 17\n;\n\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTab", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "1\\. Промежуточная таблица", "snippet": "1\\. Промежуточная таблица\nВ промежуточной таблице используются параметры:\n\n- `STORE_ID` и `BOOK_ID` — первичные ключи из таблиц `StoreTable` и `BookTable`,\n\n- `QUANTITY` — дополнительное поле для хранения количества книг.\n\n```php\nnamespac", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "2\\. Как работать со вспомогательными данными", "snippet": "2\\. Как работать со вспомогательными данными\nДля работы с вспомогательными данными используйте отдельную сущность-посредник.\n\n```php\n// Объект книги\n$book = \\Bitrix\\Main\\Test\\Typography\\BookTable::getByPrimary(1)\n ->fetchObject()\n;\n// Об", "page": "docs-orm-entity-relations", "path": "/docs/orm/entity-relations/", "title": "Отношения между сущностями"}, {"heading": "Аннотации классов", "snippet": "Аннотации классов\nБольшинство методов объекта и коллекции в ORM — виртуальные. Это значит, что их не существует в коде класса, но PHP создает их автоматически через магический метод `__call` при обращении к несуществующим методам.\n\nСистема ", "page": "docs-orm-annotations", "path": "/docs/orm/annotations/", "title": "Аннотации классов"}, {"heading": "Аннотации ORM-классов ядра", "snippet": "Аннотации ORM-классов ядра\nФайл с аннотациями ORM-классов ядра находится по пути `/bitrix/modules/main/meta/orm.php`. Этот файл содержит множество объявлений классов с блоками аннотаций в phpDoc.\n\n```php\n/* ORMENTITYANNOTATION:Bitrix\\Main\\U", "page": "docs-orm-annotations", "path": "/docs/orm/annotations/", "title": "Аннотации классов"}, {"heading": "Аннотации для классов таблиц", "snippet": "Аннотации для классов таблиц\nАннотации также добавляют phpDoc-блок перед классом таблицы.\n\n```php\n// Пример для UserTable\n/**\n * Class UserTable\n *\n * DO NOT WRITE ANYTHING BELOW THIS\n *\n * <<< ORMENTITYANNOTATION\n * @method static EO_User", "page": "docs-orm-annotations", "path": "/docs/orm/annotations/", "title": "Аннотации классов"}, {"heading": "Создать аннотации", "snippet": "Создать аннотации\nЧтобы создать аннотации, нужно перейти в папку `/bitrix/` проекта и использовать CLI-команду `orm:annotate`.\n\n```bash prompt=\"$\"\n$ cd bitrix\n$ php bitrix.php orm:annotate\n```\n\n!!! warning \"Внимание\"\n\n\n Перед использован", "page": "docs-orm-annotations", "path": "/docs/orm/annotations/", "title": "Аннотации классов"}, {"heading": "Несколько модулей, перечисляйте через запятую", "snippet": "Несколько модулей, перечисляйте через запятую\n$ php bitrix.php orm:annotate -m main,intranet\n\nВсе модули\n$ php bitrix.php orm:annotate -m all\n```\n\nУправлять аннотациями\nСистема обновляет аннотации выборочно. При повторном запуске команды пе", "page": "docs-orm-annotations", "path": "/docs/orm/annotations/", "title": "Аннотации классов"}, {"heading": "Выборка данных", "snippet": "Выборка данных\nДля выборки данных с фильтрацией, группировкой и сортировкой в Bitrix Framework используются метод `getList` и объект [`Entity\\Query`](./query-builder.md).", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Метод getList", "snippet": "Метод getList\nМетод `getList` универсален для всех сущностей и работает по общим правилам. Его невозможно изменить, но он дает гибкость для выполнения запросов.\n\nРассмотрим применение метода на примере сущности `BookTable`. Метод принимает ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Получение данных из результата", "snippet": "Получение данных из результата\nМетод `getList` возвращает объект `DB\\Result`. Данные можно получить с помощью методов `fetch()` или `fetchAll()`.\n\n```php\n// Получение данных построчно\n$rows = [];\n$result = BookTable::getList($parameters);\nw", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Select", "snippet": "Select\nПараметр `select` задается как массив с именами полей сущности.\n\n```php\nBookTable::getList([\n 'select' => ['ISBN', 'TITLE', 'PUBLISH_DATE']\n]);\n// SELECT ISBN, TITLE, PUBLISH_DATE FROM my_book\n```\n\nЧтобы изменить названия полей, и", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Filter", "snippet": "Filter\nПараметр `filter` задает условия для выборки данных в виде ассоциативного массива. Ключи массива это условия, а значения — параметры для поиска.\n\n```php\n// WHERE ID = 1\nBookTable::getList([\n 'filter' => ['=ID' => 1]\n]);\n\n// WHERE ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Group", "snippet": "Group\nПараметр `group` задает поля для группировки. Это позволяет объединять записи с одинаковыми значениями в указанных полях:\n\n```php\nBookTable::getList([\n 'group' => ['PUBLISH_DATE']\n]);\n```\n\nЧаще всего группировку указывать не нужно ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Runtime", "snippet": "Runtime\nПараметр `runtime` добавляет временные поля, которые вычисляются во время выполнения запроса.\n\n**Пример подсчета записей**\\\nДля подсчета количества записей используйте `ExpressionField`:\n\n```php\nuse Bitrix\\Main\\ORM;\n\nBookTable::getL", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Count_total", "snippet": "Count_total\nЧтобы получить список всех элементов без постраничного вывода, используйте параметр `count_total` со значением `true`:\n\n```php\n$res = MyTable::getList([\n /* ваши параметры запроса */\n 'count_total' => true,\n]);\n```\n\nЭто по", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Кеширование выборки", "snippet": "Кеширование выборки\nКеширование выборки позволяет сохранять результаты запросов для повторного использования. По умолчанию кеширование отключено.\n\nДля включения кеширования используйте ключ `cache` в методе `getList`:\n\n```php\n$res = \\Bitrix", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Короткие вызовы", "snippet": "Короткие вызовы\nДля упрощения работы с данными, помимо метода `getList`, доступны более короткие методы:\n\n- `getById($id)` — выборка по первичному ключу.\n\n- `getByPrimary($primary, array $parameters)` — выборка по первичному ключу с допол", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Предустановленные выборки", "snippet": "Предустановленные выборки\nПредустановленные выборки позволяют заранее задавать параметры для выборки данных: фильтры, сортировки или выбор полей. Их можно разделить на два уровня:\n\n1. Глобальная область данных — настройки применяются ко все", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Глобальная область данных", "snippet": "Глобальная область данных\nОдну таблицу можно описать несколькими сущностями, разделив записи на сегменты. Метод `setDefaultScope` выполняется при каждом запросе, задавая фильтры и другие параметры.\n\n```php\nuse Bitrix\\Main\\ORM\\Query\\Query;\n\n", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Локальная область данных", "snippet": "Локальная область данных\nНа пользовательском уровне можно задавать предустановленные выборки с помощью методов `with*`, аналога `setDefaultScope`.\n\n```php\nuse Bitrix\\Main\\ORM\\Query\\Query;\n\nclass UserTable\n{\n // Метод withActive добавляет", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Выбор данных из хранимых процедур вместо таблиц", "snippet": "Выбор данных из хранимых процедур вместо таблиц\nORM может использоваться для сложных запросов, таких как выборка данных из хранимых процедур в базе данных MSSQL. Хранимые процедуры — это программы, заранее сохраненные на сервере базы данных", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Решение проблемы", "snippet": "Решение проблемы\nЧтобы использовать хранимые процедуры, нужно создать собственный класс `SqlHelper`:\n\n1. Установите расширение `mssql` на сервере\n\n2. Создайте новый класс, унаследованный от `Bitrix\\Main\\DB\\SqlHelper`\n\n ```php\n class Mss", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Некорректная работа LIMIT", "snippet": "Некорректная работа LIMIT\nПри использовании метода `setLimit` в запросах с отношениями 1:N и N:M может возникнуть неожиданное поведение. Ограничение LIMIT применяется на уровне SQL-запроса и ограничивает общее количество строк в результате,", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Декартово произведение при выборке нескольких отношений", "snippet": "Декартово произведение при выборке нескольких отношений\nДекартово произведение возникает, когда каждая строка одной таблицы соединяется с каждой строкой другой таблицы, что приводит к резкому увеличению количества строк в результате. При вы", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Решение проблем", "snippet": "Решение проблем\nДля решения этих проблем используется класс `Bitrix\\Main\\ORM\\Query\\QueryHelper` с методом `decompose`.\n\n```php\npublic static function decompose(Query $query, $fairLimit = true, $separateRelations = true)\n```\n\nМетод имеет два", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Одиночные условия", "snippet": "Одиночные условия\n1. **Простой** **запрос**\n\n Для выборки данных по конкретному условию используйте метод `where`. Например, чтобы выбрать пользователя с `ID = 1`:\n\n ```php\n \\Bitrix\\Main\\UserTable::query()\n ->where(\"ID\", 1)\n ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Множественные условия", "snippet": "Множественные условия\nИспользуйте метод `where` несколько раз, чтобы добавлять несколько условий в запрос:\n\n```php\n\\Bitrix\\Main\\UserTable::query()\n ->where('ID', '>', 1)\n ->where('ACTIVE', true)\n ->whereNotNull('PERSONAL_BIRTHDAY')", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "OR и вложенные фильтры", "snippet": "OR и вложенные фильтры\nДля хранения условий фильтра используется контейнер `\\Bitrix\\Main\\Entity\\Query\\Filter\\ConditionTree`. Он позволяет добавлять другие экземпляры `ConditionTree` для создания вложенных условий.\n\n**Пример простого фильтра", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Выражения", "snippet": "Выражения\nВ фильтре можно использовать `ExpressionField`, который автоматически регистрируется как runtime поле. Это позволяет создавать сложные условия:\n\n```php\nuse Bitrix\\Main\\ORM\\Fields\\ExpressionField;\n\n\\Bitrix\\Main\\UserTable::query()\n ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Совместимость с getList", "snippet": "Совместимость с getList\nПри использовании `getList`, фильтр можно вставить вместо массива:\n\n```php\nuse Bitrix\\Main\\ORM\\Query\\Query;\n\\Bitrix\\Main\\UserTable::getList([\n 'filter' => ['=ID' => 1]\n]);\n\n\\Bitrix\\Main\\UserTable::getList([\n 'f", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Условия JOIN", "snippet": "Условия JOIN\nРеференсы — это связи между таблицами, которые позволяют объединять данные из разных таблиц. Они описываются с помощью `ReferenceField`:\n\n```php\nuse Bitrix\\Main\\Entity;\nuse Bitrix\\Main\\ORM\\Query\\Join;\n\nnew Entity\\ReferenceField", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Формат массива", "snippet": "Формат массива\nДля использования фильтра в виде массива существует метод конвертации из массива в объект `\\Bitrix\\Main\\ORM\\Query\\Filter\\ConditionTree::createFromArray`. Формат массива:\n\n```php\n$filter = [\n ['FIELD', '>', 2],\n [\n ", "page": "docs-orm-querying-data", "path": "/docs/orm/querying-data/", "title": "Выборка данных"}, {"heading": "Построитель запросов", "snippet": "Построитель запросов\nМетоды выборки `getList` и `getRow` сразу выполняют запросы и возвращают результаты. Они подходят для простых запросов, но неудобны, если параметры неизвестны заранее или нужна сложная логика.\n\n**Гибкость с Entity\\\\Quer", "page": "docs-orm-query-builder", "path": "/docs/orm/query-builder/", "title": "Построитель запросов"}, {"heading": "Постепенное добавление параметров", "snippet": "Постепенное добавление параметров\nЕсли вы не знаете заранее, какие поля выбрать или какие фильтры применить, используйте объект `Query` для постепенного добавления параметров.\n\n```php\n$query = new Entity\\Query(BookTable::getEntity());\nattac", "page": "docs-orm-query-builder", "path": "/docs/orm/query-builder/", "title": "Построитель запросов"}, {"heading": "Запрос без выполнения", "snippet": "Запрос без выполнения\nОбъект `Query` позволяет строить запрос без его выполнения. Это полезно для подзапросов или получения текста запроса:\n\n```php\n$q = new Entity\\Query(BookTable::getEntity());\n$q->setSelect(['ID']);\n$q->setFilter(['=PUBLI", "page": "docs-orm-query-builder", "path": "/docs/orm/query-builder/", "title": "Построитель запросов"}, {"heading": "Методы Entity\\\\Query", "snippet": "Методы Entity\\\\Query\n**select, group**\n\n- `setSelect`, `setGroup` — задает список полей, полностью заменяя предыдущие\n\n- `addSelect`, `addGroup` — добавляет новые поля к существующему списку\n\n- `getSelect`, `getGroup` — возвращает массив", "page": "docs-orm-query-builder", "path": "/docs/orm/query-builder/", "title": "Построитель запросов"}, {"heading": "Сайты", "snippet": "Сайты\nКаждый сайт в рамках Bitrix Framework состоит из трех ключевых элементов.\n\n1. Регистрационная запись в таблице `b_lang`.\n\n2. Файловая структура:\n\n - публичные файлы сайта,\n\n - шаблон сайта,\n\n - пользовательские доработки в `/", "page": "docs-cms-basics-sites", "path": "/docs/cms-basics/sites/", "title": "Сайты"}, {"heading": "Как создать новый сайт", "snippet": "Как создать новый сайт\n1. На странице со списком сайтов нажмите Добавить сайт.\n\n2. Заполните параметры сайта:\n\n - ID — уникальный идентификатор сайта. Это двузначный код из латинских букв и цифр.\n\n - Активен — отметьте опцию, чтобы са", "page": "docs-cms-basics-sites", "path": "/docs/cms-basics/sites/", "title": "Сайты"}, {"heading": "Как изменить домен сайта", "snippet": "Как изменить домен сайта\n1. Приобретите новый домен.\n\n2. Привяжите домен к хостингу:\n\n - если хостинг и домен у одного провайдера, привязка происходит автоматически или по инструкциям от провайдера,\n\n - если хостинг и домен у разных п", "page": "docs-cms-basics-sites", "path": "/docs/cms-basics/sites/", "title": "Сайты"}, {"heading": "Шаблоны сайтов", "snippet": "Шаблоны сайтов\nШаблон — это макет сайта. Он задает внешний вид страниц, расположение меню, логотипа, рекламы, формы авторизации и других элементов.\n\nШаблон состоит:\n\n- из HTML-разметки,\n\n- CSS-стилей,\n\n- графических элементов,\n\n- шаблон", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Основные части шаблона", "snippet": "Основные части шаблона\nШаблон делится на три основные части.\n\n1. Header или шапка сайта — верхняя часть сайта, хранится в файле `<идентификатор_шаблона>/header.php`. Содержит логотип, название сайта, меню.\n\n2. Рабочая область — место для ко", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Где хранятся шаблоны", "snippet": "Где хранятся шаблоны\nШаблоны хранятся в двух папках:\n\n- системные шаблоны размещены в `/bitrix/templates`,\n\n- пользовательские шаблоны следует хранить в `/local/templates`.\n\n!!! warning \"Внимание\"\n\n\n Шаблон Битрикс24 `/bitrix/templates", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Как создать шаблон", "snippet": "Как создать шаблон\nШаблон можно создать через административный интерфейс системы.\n\n!!! note \"Примечание\"\n\n\n На время создания шаблона рекомендуется отключить кеширование, чтобы сразу видеть изменения. Откройте страницу *Настройки > Настр", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Как отредактировать шаблон", "snippet": "Как отредактировать шаблон\nОткрыть шаблон для редактирования можно двумя способами.\n\n- **Через административный раздел**. Откройте список шаблонов и в меню шаблона нажмите пункт Изменить.\n\n ![](./_images/site-templates-3.png){width=695px", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Экспорт и импорт", "snippet": "Экспорт и импорт\nШаблон можно экспортировать в файл `<идентификатор_шаблона>.tar.gz`. Для этого в меню шаблона нажмите Скачать .\n\n![](./_images/site-templates-2.png){width=636px height=330px}\n\nГотовый шаблон можно загрузить в систему с помо", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Порядок работы", "snippet": "Порядок работы\n1. При обработке запроса система перебирает шаблоны по возрастанию значения сортировки.\n\n2. Для каждого шаблона проверяется его условие применения.\n\n3. Применяется первый шаблон, условие которого выполняется. Остальные шаблон", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Примеры", "snippet": "Примеры\nТаблица показывает, как можно задавать условия в зависимости от выбранного типа и когда будет применен шаблон.\n\n| Тип условия | Пример условия | Когда применяется шаблон |\n| ----------- | -------------- | ------------------------ |\n", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Рекомендации по созданию шаблона", "snippet": "Рекомендации по созданию шаблона\n- Разделяйте графический дизайн на верхнюю `header.php` и нижнюю `footer.php` части заранее. Это позволяет повторно использовать части шаблона и улучшает структуру сайта.\n\n- Настраивайте стили заранее. Зад", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Как развернуть шаблон", "snippet": "Как развернуть шаблон\nСоздайте шаблон на локальной версии продукта. Готовый шаблон экспортируйте в виде архива `tar.gz` или распакуйте из архива в папке `/local/templates/`.\n\nНесколько шаблонов для сайта\nДля сайта можно создать несколько ша", "page": "docs-cms-basics-site-templates", "path": "/docs/cms-basics/site-templates/", "title": "Шаблоны сайтов"}, {"heading": "Шаблоны страницы", "snippet": "Шаблоны страницы\nВ Bitrix Framework страница — это PHP-файл, который состоит из трех частей.\n\n1. Header или шапка сайта — общие элементы сайта.\n\n2. Основная рабочая область — уникальный контент страницы, который может быть:\n\n - статическ", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Шаблоны страниц", "snippet": "Шаблоны страниц\nШаблон страницы — это PHP-файл, который содержит структуру страницы и соответствует правилам оформления.\n\nСобственные шаблоны страниц размещайте в папках пользовательских шаблонов сайта:\n\n- `/local/templates/.default/page_t", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Пассивный шаблон", "snippet": "Пассивный шаблон\nПассивный шаблон — это шаблон с заготовленным контентом для новой страницы.\n\nКак создать пассивный шаблон\n**Первый способ**. Скопировать штатный шаблон\n\n`/bitrix/templates/.default/page_templates/standard.php` в `/local/tem", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Как подключить пассивный шаблон", "snippet": "Как подключить пассивный шаблон\nЧтобы шаблон появился в меню создания страницы, в файл `/local/templates/[идентификатор_шаблона]/page_templates/.content.php` добавьте строку:\n\n```php\nTEMPLATE[\"new.php\"] = [\"name\" => \"Новый шаблон\", \"sort\" =", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Языковые файлы", "snippet": "Языковые файлы\nИспользуйте языковые файлы для шаблонов, если сайт использует несколько языков. В этом случае в файле `.content.php` вместо названия шаблона будет использоваться метод `GetMessage(\"new\")`:\n\n```php\nuse Bitrix\\Main\\Localization", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Пример создания пассивного шаблона", "snippet": "Пример создания пассивного шаблона\nБудет создан общий шаблон страницы объявления, который доступен для всех шаблонов сайта.\n\n1. В папке `/local/templates/.default/page_templates` создайте файл `announcement.php`.\n\n2. Добавьте код шаблона и ", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Активный шаблон", "snippet": "Активный шаблон\nАктивный шаблон — это шаблон, который при создании страницы запрашивает дополнительные данные у контент-менеджера. Эти данные можно использовать для настройки структуры или содержимого страницы.\n\n![](./_images/page-templates", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Примеры шаблонов", "snippet": "Примеры шаблонов\nСвой активный шаблон можно создать на основе штатных примеров.\n\n- В дистрибутиве 1С-Битрикс24 есть пример активного шаблона: `/bitrix/templates/.default/page_templates/forum`.\n\n- В 1С-Битрикс: Управление сайтом дополнител", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Структура шаблона", "snippet": "Структура шаблона\nВ папке шаблона обязательно должен быть файл `template.php`. Он содержит логику шаблона.\n\nДополнительно могут быть другие файлы и папки:\n\n- папка `/lang` — языковые файлы,\n\n- папка `/images` — изображения для шаблона.\n\nК", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Пример создания активного шаблона", "snippet": "Пример создания активного шаблона\nАктивный шаблон будет создан на основе штатного шаблона `bootstrap` и [пассивного шаблона](./page-templates.md#пример-создания-пассивного-шаблона) `announcement.php`. В форме создания страницы новый шаблон", "page": "docs-cms-basics-page-templates", "path": "/docs/cms-basics/page-templates/", "title": "Шаблоны страницы"}, {"heading": "Свойства страницы и раздела", "snippet": "Свойства страницы и раздела\nСвойства страницы и раздела хранят служебные значения для шаблона сайта, компонентов и кода страницы. Через свойства задают SEO-метаданные, заголовок окна браузера и другие значения, которые отличаются на страниц", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Добавить тип свойства", "snippet": "Добавить тип свойства\nЧтобы редакторы могли заполнять свойства через интерфейс, добавьте нужные типы свойств в настройках модуля Управление структурой.\n\n1. В административном разделе откройте страницу *Настройки > Настройки продукта > Настр", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Чем свойства отличаются от заголовка страницы", "snippet": "Чем свойства отличаются от заголовка страницы\nОсновной заголовок страницы хранится отдельно от свойств страницы и раздела. Его задают методом `SetTitle()` и получают методом `GetTitle()`.\n\nСвойство `title` — зарезервированное свойство стран", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Свойства страницы через административную часть", "snippet": "Свойства страницы через административную часть\n1. Откройте *Контент > Структура сайта > Файлы и папки*.\n\n2. Перейдите в папку, в которой размещена страница.\n\n3. Нажмите *Редактировать как HTML* или *Редактировать как текст* в меню нужной ст", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Свойства страницы через API", "snippet": "Свойства страницы через API\nЧтобы задать свойство текущей страницы, вызовите `SetPageProperty(property_id, property_value, Options)` в коде страницы или компонента.\n\n- `property_id` — код свойства.\n\n- `property_value` — значение свойства.", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Свойства раздела через публичную часть", "snippet": "Свойства раздела через публичную часть\n1. Откройте раздел в публичной части сайта.\n\n2. Нажмите *Изменить раздел > Заголовок и свойства страницы* на административной панели.\n\n ![](./_images/properties-6.png){width=536px height=298px}\n\n3. З", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Свойства раздела через API", "snippet": "Свойства раздела через API\nСвойства раздела хранятся в файле `.section.php` соответствующей папки. Чтобы задать значение из кода, используйте `SetDirProperty(property_id, property_value, path)`.\n\n- `property_id` — код свойства.\n\n- `proper", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "GetPageProperty()", "snippet": "GetPageProperty()\nМетод `GetPageProperty(property_id, default_value)` возвращает свойство страницы.\n\n- `property_id` — код свойства.\n\n- `default_value` — значение по умолчанию. Метод возвращает его, если свойство страницы не найдено.\n\n```", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "GetProperty()", "snippet": "GetProperty()\nМетод `GetProperty(property_id, default_value)` сначала проверяет свойство текущей страницы. Если свойство не найдено, метод ищет свойство раздела с учетом наследования.\n\n- `property_id` — код свойства.\n\n- `default_value` — ", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Вывод свойства в виде метатега", "snippet": "Вывод свойства в виде метатега\nДля SEO-метаданных используйте `ShowMeta(id, meta_name, bXhtmlStyle)`.\n\n- `id` — код свойства. По умолчанию метод использует код как значение атрибута `name` в HTML-метатеге.\n\n- `meta_name` — другое значение", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Учесть отложенный вывод", "snippet": "Учесть отложенный вывод\nМетоды `GetPageProperty()`, `GetDirProperty()` и `GetProperty()` сразу возвращают значение свойства в момент вызова. Если компонент установит свойство позже через `SetPageProperty()`, ранний вызов `GetPageProperty()`", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Учесть приоритет значений", "snippet": "Учесть приоритет значений\nДля одного типа свойства система использует самое близкое значение к текущей странице.\n\n- Если значение задано на странице, оно имеет наивысший приоритет.\n\n- Если на странице значения нет, система проверяет свойс", "page": "docs-cms-basics-properties", "path": "/docs/cms-basics/properties/", "title": "Свойства страницы и раздела"}, {"heading": "Заголовки страницы: на сайте и в браузере", "snippet": "Заголовки страницы: на сайте и в браузере\nBitrix Framework позволяет задать заголовок страницы. Пользователь видит его на странице сайта. Без дополнительных настроек этот текст отображается во вкладке браузера.\n\nЧтобы адаптировать страницу ", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Как устроены заголовки", "snippet": "Как устроены заголовки\n**Основной заголовок страницы.** Хранится в переменной отдельно от свойств страницы и раздела. Разработчик размещает код вывода заголовка в шаблоне сайта, обычно в теге `

`. Чтобы задать основной заголовок, использ", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Поле для свойства title", "snippet": "Поле для свойства title\nВ интерфейсе поле для свойства `title` может называться *Заголовок окна браузера* или *Дополнительный заголовок*.\n\n![](./_images/titles-2.png){width=632px height=481px}\n\nЕсли поле отсутствует, добавьте свойство в нас", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Краткий справочник по методам", "snippet": "Краткий справочник по методам\nМетоды `SetTitle()` и `SetPageProperty()` только задают значения. За вывод заголовков отвечает шаблон сайта — разработчик размещает `ShowTitle()` в нужных местах.\n\n#|\n|| **Что нужно сделать** | **Что использова", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Задать основной заголовок страницы", "snippet": "Задать основной заголовок страницы\nОсновной заголовок можно задать через интерфейс или в коде страницы.\n\n!!! warning \"Внимание\"\n\n\n В некоторых компонентах, например, в `bitrix:news` или `bitrix:catalog` есть параметр *Устанавливать загол", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Установить заголовок через API", "snippet": "Установить заголовок через API\nЧтобы установить основной заголовок, вызовите метод `SetTitle()` в самом начале кода страницы.\n\n```php\nSetTitle(\"О магазине\");\n?>\n", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Установить через API", "snippet": "Установить через API\nДобавьте вызов метода `SetPageProperty` в код страницы.\n\n```php\nSetTitle(\"О магазине\");\n$APPLICATION->SetPageProperty(\"title\", \"Магазин одеж", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Получить основной заголовок через API", "snippet": "Получить основной заголовок через API\nЧтобы получить основной заголовок страницы в коде, используйте `GetTitle()` без аргументов. Такой вызов эквивалентен `GetTitle(false)` и возвращает значение, которое установлено через `SetTitle()`.\n\n```", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Вывести заголовки в шаблоне сайта", "snippet": "Вывести заголовки в шаблоне сайта\nШаблон сайта определяет, где показать основной заголовок и где вывести свойство `title`. Разместите код вывода в файле шаблона `header.php`. Например, в `bitrix/templates/.default/header.php` или в шаблоне,", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Заголовок окна браузера в теге title", "snippet": "Заголовок окна браузера в теге title\nДля заголовка окна браузера разместите `ShowTitle()` внутри тега `` в области `<head>`.\n\n```php\n<head>\n <title><?php $APPLICATION->ShowTitle(); ?>\n\n```\n\nМетод сначала проверяет с", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Учесть приоритет заголовков", "snippet": "Учесть приоритет заголовков\nЕсли на странице несколько методов или компонентов устанавливают заголовок, система использует значение из последнего вызова. Последнее значение всегда перезаписывает предыдущее.\n\nПри этом важно различать основно", "page": "docs-cms-basics-titles", "path": "/docs/cms-basics/titles/", "title": "Заголовки страницы: на сайте и в браузере"}, {"heading": "Работа со стилями", "snippet": "Работа со стилями\nСтили отвечают за внешний вид элементов сайта: шрифты, цвета, отступы, рамки, меню, таблицы и другие блоки. В Bitrix Framework стили хранятся рядом с элементом, который они оформляют. Шаблоны сайта содержат каркас, шаблоны", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Где хранить CSS", "snippet": "Где хранить CSS\n#|\n|| **Где хранится** | **Что оформляет** | **Основные файлы** ||\n|| Шаблон сайта | Общий каркас сайта: шапку, подвал, сетку, фон, базовую типографику, стили визуального редактора | `template_styles.css`, `styles.css`, `.st", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Настроить стили шаблона сайта", "snippet": "Настроить стили шаблона сайта\nШаблон сайта задает общий макет страниц: HTML-разметку, рабочую область, меню, логотип, подвал, изображения и базовые CSS-файлы.\n\nШаблоны сайта хранятся в папках:\n\n- `/local/templates/<идентификатор_шаблона>/`", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Разделить styles.css и template_styles.css", "snippet": "Разделить styles.css и template_styles.css\nФайл `template_styles.css` хранит стили самого шаблона: шапки, подвала, колонок, сетки, фона и других элементов вне рабочей области.\n\nФайл `styles.css` хранит стили содержимого страницы. Эти правил", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Изменить стили через административный раздел", "snippet": "Изменить стили через административный раздел\nСтили шаблона можно редактировать из административного раздела.\n\n1. Откройте страницу *Настройки > Настройки продукта > Сайты > Шаблоны сайтов*.\n\n2. В меню нужного шаблона выберите пункт Изменить", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Добавить стиль в визуальный редактор", "snippet": "Добавить стиль в визуальный редактор\nВизуальный редактор использует стили из `styles.css` и описания из `.styles.php`. CSS-правило задает внешний вид, а `.styles.php` добавляет пункт в список стилей редактора.\n\nСоздайте правило в `styles.cs", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Подключить CSS только для визуального редактора", "snippet": "Подключить CSS только для визуального редактора\nЕсли редактору нужны дополнительные CSS-файлы, добавьте параметр `EDITOR_STYLES` в `description.php` шаблона сайта.\n\n```php\n 'Название шаблона',\n 'EDITOR_", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Оформить шаблон компонента", "snippet": "Оформить шаблон компонента\nКомпонент получает данные и передает их в шаблон. Шаблон компонента преобразует данные в HTML и хранит ресурсы, которые нужны именно этой разметке.\n\nШаблон компонента обычно содержит:\n\n- `template.php` — основной", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Добавить стили в JS-расширения", "snippet": "Добавить стили в JS-расширения\nРасширение объединяет JavaScript и CSS в клиентский модуль. Используйте расширения для интерфейсов, которые живут в браузере и подключаются как самостоятельный ресурс: попапов, меню, полей ввода, подсказок, ик", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Подключить CSS вручную", "snippet": "Подключить CSS вручную\nРучное подключение используют, когда CSS-файл не принадлежит шаблону компонента или JS-расширению, но требуется на конкретной странице.\n\nКлассические методы `$APPLICATION->ShowCSS()` и `$APPLICATION->SetAdditionalCSS(", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "API подключения CSS", "snippet": "API подключения CSS\n#|\n|| **API** | **Где и когда использовать** | **Что подключает** ||\n|| `$APPLICATION->ShowCSS()` | В `header.php` классического шаблона сайта внутри ``, когда нужно вывести CSS, зарегистрированный на странице и в ", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Выбрать способ подключения", "snippet": "Выбрать способ подключения\nВыберите способ по сценарию.\n\n#|\n|| **Сценарий** | **Где хранить или подключать CSS** ||\n|| Нужно изменить шапку, подвал, сетку или фон сайта | В `template_styles.css` шаблона сайта ||\n|| Нужно добавить стиль текс", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Учесть нюансы Bitrix Framework", "snippet": "Учесть нюансы Bitrix Framework\n**Не смешивайте владельцев CSS.** Если один и тот же блок оформлен и в `template_styles.css`, и в `style.css` компонента, сложнее понять источник правила и порядок переопределения. Для повторяемого блока предп", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Оптимизировать CSS", "snippet": "Оптимизировать CSS\nBitrix Framework может объединять и сжимать CSS-файлы, чтобы уменьшить количество запросов к серверу. Настройки находятся на странице *Настройки > Настройки продукта > Настройки модулей > Главный модуль*.\n\n![](./_images/s", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Как система собирает файлы", "snippet": "Как система собирает файлы\nЕсли условия выполнены, Bitrix Framework выбирает подходящие CSS-файлы и собирает их в общий файл. Система сохраняет:\n\n- результат в папке `/bitrix/cache/css//<идентификатор_шаблона>/`,\n\n- служебную инф", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Как работает gzip-сжатие", "snippet": "Как работает gzip-сжатие\nGzip-сжатие работает отдельно от объединения. Метод `gzipEnabled()` возвращает `true`, если выполнены три условия:\n\n- модуль `main` использует опцию `compres_css_js_files`,\n\n- PHP загрузил расширение `zlib`,\n\n- ф", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Проверить результат", "snippet": "Проверить результат\nПосле изменения CSS проверьте:\n\n- публичную страницу, где используется шаблон сайта,\n\n- страницу с компонентом, шаблон которого вы изменили,\n\n- визуальный редактор, если меняли `styles.css`, `.styles.php` или `EDITOR_", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Разобрать типовые ошибки", "snippet": "Разобрать типовые ошибки\n**Стиль шаблона сайта не применился.** Проверьте, что правило добавлено в файл того шаблона сайта, который выбран для текущей страницы. Если правило находится в `styles.css`, убедитесь, что оно относится к рабочей о", "page": "docs-cms-basics-styles", "path": "/docs/cms-basics/styles/", "title": "Работа со стилями"}, {"heading": "Работа с почтой", "snippet": "Работа с почтой\nBitrix Framework обрабатывает входящие и исходящие письма отдельно.\n\n1. Входящие — через модуль Почта. Он подключает ящики, забирает письма с сервера и применяет правила обработки.\n\n2. Исходящие — через почтовые события. Они", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Настройки модуля", "snippet": "Настройки модуля\nЧтобы работать с почтой, настройте параметры модуля.\n\n1. Откройте страницу *Настройки > Настройки продукта > Настройки модулей > Почта*.\n\n2. На вкладке Настройки задайте параметры обработки и хранения писем.\n\n - Встраива", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Почтовые ящики", "snippet": "Почтовые ящики\nСуществует два типа почтовых ящиков.\n\n- Системный — предназначен для служебных задач.\n\n- Пользовательский — создается пользователем на сайте или администратором в административном разделе.\n\nКак добавить почтовый ящик\n!!! no", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Cистемный ящик", "snippet": "Cистемный ящик\nСоздайте системный ящик, чтобы принимать обращения в техподдержку, публиковать сообщения на форумах, обрабатывать письма в CRM.\n\nНа вкладке Почтовый ящик укажите настройки подключения.\n\n- Название — введите название, которое", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Пользовательский ящик", "snippet": "Пользовательский ящик\nЧтобы подключить к сайту личный ящик сотрудника, добавьте пользовательский ящик и укажите параметры подключения.\n\n- Почтовый сервис — выберите один из сервисов, который добавлен в разделе *Сервисы > Почта > Почтовые с", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Правила обработки", "snippet": "Правила обработки\nПравила обработки помогают отметить письмо как прочитанное, определить спам, удалить ненужные письма. Существует четыре типа правил.\n\n- Ручная настройка — общие настройки для обработки писем.\n\n- Добавление сообщений в фо", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Как добавить правило", "snippet": "Как добавить правило\n1. Откройте страницу *Сервисы > Почта > Правила*.\n\n2. Нажмите Добавить правило и выберите тип.\n\n ![](./_images/mail-5.png){width=703px height=437px}\n\n3. Заполните поля на вкладке Параметры.\n\n - Почтовый ящик — укаж", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Как работать с письмами", "snippet": "Как работать с письмами\nСписок писем хранится на странице *Сервисы > Почта > Письма*. Иконки рядом с письмами показывают их статус.\n\n![](./_images/mail-12.png){width=700px height=482px}\n\nПолучить почту вручную\nВ поле Получить почту выберите", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Почтовые сервисы", "snippet": "Почтовые сервисы\nПочтовые сервисы — это внешние провайдеры, через которых пользователи подключают ящики в системе. Администратор управляет списком на странице *Сервисы > Почта > Почтовые сервисы*.\n\n![](./_images/mail-16.png){width=679px he", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Настройка окружения", "snippet": "Настройка окружения\nСообщения можно отправлять через один из трех вариантов.\n\n- Локальный агент `sendmail` или `postfix` для сайта на Linux.\n\n- Внешний SMTP-сервер без авторизации для сайта на Windows.\n\n- Внешний SMTP-сервер с авторизаци", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Настройка на Linux", "snippet": "Настройка на Linux\nПример составлен для CentOS 5.\n\n1. Удалите `sendmail`.\n\n ```bash prompt=\"$\"\n $ rpm -e --nodeps sendmail\n ```\n\n2. Установите `postfix`.\n\n ```bash prompt=\"$\"\n $ yum install postfix\n $ /etc/postfix/post-install u", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Настройка на VMBitrix", "snippet": "Настройка на VMBitrix\n1. Запустите виртуальную машину.\n\n2. Войдите в VMBitrix под пользователем root.\n\n3. В главном меню перейдите *8\\. Configure pool sites > 4. Change a site's e-mail settings*.\n\n4. Введите имя хоста, для которого нужно на", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Решение проблем", "snippet": "Решение проблем\nНа странице *Настройки > Инструменты > Проверка сайта* может отображаться ошибка *Есть ошибки при отправке системных почтовых сообщений.* Возможная причина — включена отправка через cron.\n\nРешение: отключите cron в файле `/b", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Как создать тип события", "snippet": "Как создать тип события\n1. Откройте страницу *Настройки > Настройки продукта > Почтовые и СМС события > Типы событий.*\n\n2. Нажмите Добавить тип.\n\n3. Заполните параметры:\n\n - Тип события — укажите латинскими буквами кодовое название событ", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Почтовые шаблоны", "snippet": "Почтовые шаблоны\nПочтовые шаблоны управляют внешним видом исходящих писем. Их настраивают на странице *Настройки > Настройки продукта > Почтовые и СМС события > Почтовые шаблоны*.\n\n![](./_images/mail-21.png){width=700px height=444px}", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Как настроить шаблон", "snippet": "Как настроить шаблон\n1. Нажмите Добавить шаблон для нового шаблона или Изменить, чтобы отредактировать существующий шаблон.\n\n ![](./_images/mail-22.png){width=536px height=347px}\n\n2. Настройте параметры шаблона.\n\n - Тип почтового собы", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Макросы", "snippet": "Макросы\nВнизу формы редактирования шаблона перечислены макросы, которые в нем доступны. Их можно вставлять в любое поле.\n\n![](./_images/mail-26.png){width=554px height=236px}\n\n!!! warning \"Внимание\"\n\n\n Если в описании макроса указано «ус", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Компоненты", "snippet": "Компоненты\nВ тело письма можно вставлять компоненты. Они позволяют добавить динамические данные, например, список товаров или информацию по заказу.\n\n1. Включите формат сообщения — Визуальный редактор.\n\n2. Перетащите компонент из списка в ра", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Как протестировать шаблон", "snippet": "Как протестировать шаблон\n1. Откройте форму почтового шаблона.\n\n2. В поле Кому укажите собственный email.\n\n3. Отправьте письмо и проверьте внешний вид.\n\n4. Если все правильно, заполните поля нужными адресами.", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Темы оформления", "snippet": "Темы оформления\nТема оформления — это шаблон внешнего вида письма. Он определяет расположение элементов письма, художественный стиль и способ отображения текста сообщения. Тема включает в себя программный HTML-код, таблицы стилей и дополни", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "API почтовой системы {#api}", "snippet": "API почтовой системы {#api}\nРаботу по отправке писем можно выполнять через API, без участия административной части.\n\nСоздать тип события\nЧтобы зарегистрировать тип события, используйте метод `CEventType::Add()`. Он возвращает `ID` нового ти", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Создать почтовый шаблон", "snippet": "Создать почтовый шаблон\nШаблон привязан к типу события по `EVENT_NAME`. Чтобы его добавить, используйте метод `CEventMessage::Add()`. Он возвращает `ID` шаблона или `false` при ошибке. Текст ошибки сохраняется в свойстве `LAST_ERROR` объект", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Вызвать почтовое событие", "snippet": "Вызвать почтовое событие\nПочтовое событие можно отправить методом `\\Bitrix\\Main\\Mail\\Event::send`. Это аналог метода из старого ядра `CEvent::Send`. В метод передайте массив параметров события.\n\n- `EVENT_NAME` — код типа события.\n\n- `LID`", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Настроить поведение почтовой системы", "snippet": "Настроить поведение почтовой системы\nНа отправку писем можно повлиять, если изменить настройки Главного модуля.\n\n- `CONVERT_UNIX_NEWLINE_2_WINDOWS` — конвертировать символы новой строки Unix формата в Windows формат при отправке email.\n\n- ", "page": "docs-cms-basics-mail", "path": "/docs/cms-basics/mail/", "title": "Работа с почтой"}, {"heading": "Работа с СМС", "snippet": "Работа с СМС\nBitrix Framework использует СМС, чтобы уведомлять пользователей. Отправляет СМС модуль Служба сообщений. Он соединяет систему с разными СМС-провайдерами.\n\nКак работает отправка СМС\n1. Код приложения создает СМС-событие с данным", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Создать тип события", "snippet": "Создать тип события\nТип события — это идентификатор, который связывает код с шаблонами СМС.\n\nЧтобы создать новый тип события, откройте страницу *Настройки > Почтовые и СМС события > Типы событий* и нажмите Добавить тип.\n\n![](./_images/sms-5", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Создать шаблон", "snippet": "Создать шаблон\nШаблон задает текст сообщения для системных уведомлений.\n\n![](./_images/sms-3.png){width=662px height=555px}\n\n- Название события — выберите тип события, который свяжет код и шаблон.\n\n- Активен — отметка, что система может и", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Конструктор", "snippet": "Конструктор\n```php\n__construct(string $eventName, array $fields = [])\n```\n\n- `$eventName` — имя СМС-события, совпадает с полем `EVENT_NAME` в шаблоне.\n\n- `$fields` — массив данных для подстановки.\n\nПример:\n\n```php\n$event = new \\Bitrix\\Mai", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить СМС", "snippet": "Отправить СМС\nМетод `send($directly)` отправляет СМС.\n\n- `$directly` — по умолчанию имеет значение `false`, то есть сообщение попадает в очередь. Если установить `true` , сообщение отправится без очереди.\n\n```php\n$result = $event->send(fal", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить СМС через очередь", "snippet": "Отправить СМС через очередь\nСообщение отправится через систему очередей после завершения текущего запроса.\n\n```php\nuse Bitrix\\Main\\Sms\\Event;\n\n// Создаем событие с данными для подстановки в шаблон\n$event = new Event('USER_CONFIRM_PHONE', [\n", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить сообщение по ID шаблона", "snippet": "Отправить сообщение по ID шаблона\nПример использует конкретный шаблон по `ID`. Система не ищет шаблон по имени события.\n\n```php\n// Используем конкретный шаблон, минуя поиск по имени события\n$result = (new Event('IGNORED_EVENT', $fields)) /", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Событие onBeforeSendSms", "snippet": "Событие onBeforeSendSms\nПеред отправкой сообщения система вызывает событие `main:onBeforeSendSms`. Обработчик получает объект сообщения. Он может проверить данные или изменить текст. Если обработчик вернет ошибку, система не отправит сообще", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Установить модуль", "snippet": "Установить модуль\nЧтобы установить модуль Служба сообщений, откройте страницу *Настройки > Настройки продукта > Модули* в административном разделе. В списке найдите модуль и нажмите кнопку Установить.\n\n![](./_images/sms.png){width=733px hei", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Класс SmsManager", "snippet": "Класс SmsManager\nКласс `\\Bitrix\\MessageService\\Sender\\SmsManager` предоставляет единый интерфейс для работы с СМС-провайдерами. Он автоматически определяет доступные сервисы отправки и управляет процессом отправки сообщений.\n\nПровайдеры\nКаж", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Методы", "snippet": "Методы\nПодключите модуль `messageservice`, чтобы использовать методы.\n\n```php\nCModule::IncludeModule('messageservice');\n```\n\n- `getSenders` — получает список всех доступных провайдеров.\n\n```php\n$senders = \\Bitrix\\MessageService\\Sender\\SmsM", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Зарегистрировать провайдера", "snippet": "Зарегистрировать провайдера\nЧтобы добавить провайдера:\n\n- создайте класс провайдера — наследник `\\Bitrix\\MessageService\\Sender\\Base`,\n\n- зарегистрируйте класс через событие.\n\n```php\n$eventManager = \\Bitrix\\Main\\EventManager::getInstance()", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить сообщение", "snippet": "Отправить сообщение\nМетод `sendMessage()` отправляет сообщение через указанного провайдера. Сообщение добавляется в очередь отправки.\n\n```php\n\\Bitrix\\MessageService\\Sender\\SmsManager::sendMessage([\n 'SENDER_ID' => \\Bitrix\\MessageService\\", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить сообщение с расширенной настройкой", "snippet": "Отправить сообщение с расширенной настройкой\nМетод `createMessage()` дает больше контроля над отправкой СМС. Используйте его, чтобы задать дополнительные параметры или заголовки.\n\nС помощью метода можно:\n\n- настроить дополнительные парамет", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Отправить сообщение без очереди", "snippet": "Отправить сообщение без очереди\nМетод `sendMessageDirectly()` отправляет сообщение немедленно, без помещения в очередь. Используйте этот метод для срочных сообщений.\n\n```php\n$result = \\Bitrix\\MessageService\\Sender\\SmsManager::sendMessageDir", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Создать сообщение по шаблону", "snippet": "Создать сообщение по шаблону\nМетод `createMessageListByTemplate()` создает список сообщений на основе СМС-шаблонов. Система автоматически находит шаблоны по имени события и подставляет переданные данные.\n\n```php\n// Данные для подстановки в ", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Проверить статус сообщения", "snippet": "Проверить статус сообщения\nМетод `getMessageStatus()` позволяет получить текущий статус отправленного сообщения. Статус помогает отслеживать доставку и обрабатывать ошибки.\n\n```php\n// Получаем статус сообщения по его ID\n$status = \\Bitrix\\Me", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Обработка ошибок", "snippet": "Обработка ошибок\nМетоды отправки возвращают объект `Bitrix\\Main\\Result`. Используйте этот объект для проверки результата операции. Если отправка не удалась, получите список ошибок.\n\n```php\n$result = \\Bitrix\\MessageService\\Sender\\SmsManager:", "page": "docs-cms-basics-sms", "path": "/docs/cms-basics/sms/", "title": "Работа с СМС"}, {"heading": "Пользователи", "snippet": "Пользователи\nПользователь — это учетная запись с логином, паролем и определенными правами доступа.\n\nСписок всех пользователей находится в административном разделе на странице *Настройки > Пользователи > Список пользователей*. Адрес страницы", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Как добавить или изменить пользователя", "snippet": "Как добавить или изменить пользователя\n1. Откройте страницу *Настройки > Пользователи > Список пользователей.*\n\n2. Выберите действие:\n\n - создать нового пользователя — нажмите Добавить пользователя,\n\n - изменить существующего — найдит", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Вкладки формы редактирования", "snippet": "Вкладки формы редактирования\nКаждая вкладка отвечает за определенный блок настроек учетной записи.\n\n**Пользователь.** Настройка общих параметров пользователя: имени, логина, пароля, адреса электронной почты. Обязательные поля: Логин, Новый ", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Как настроить права доступа", "snippet": "Как настроить права доступа\nПрава доступа к разделам и инструментам сайта настраиваются [на уровне группы](./user-groups). Пользователь может состоять в нескольких группах. Если права различаются, пользователь получает наиболее высокий уров", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Добавить нового пользователя", "snippet": "Добавить нового пользователя\n```php\n$user = new CUser();\n$id = $user->Add([\n \"NAME\" => \"Иван\",\n \"LAST_NAME\" => \"Петров\",\n \"EMAIL\" => \"ipetrov@example.ru\",\n \"LOGIN\" => \"ipetrov\",\n \"LID\" => \"s1\",\n \"ACTIVE\" => \"Y\",\n \"GROUP", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Выполнить авторизацию пользователя", "snippet": "Выполнить авторизацию пользователя\n```php\nglobal $USER;\n\n/**\n * @var \\CUser $USER\n */\n\n$authResult = $USER->Login($login, $password, \"Y\");\nif ($authResult === true)\n{\n // Пользователь успешно авторизовался\n LocalRedirect(\"/personal/\")", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Выбрать пользователей по фильтру", "snippet": "Выбрать пользователей по фильтру\nКод выводит всех пользователей с именем `Иван` и фамилией `Петров`.\n\n```php\nuse Bitrix\\Main\\UserTable;\n\n$users = UserTable::query()\n ->setSelect(['ID', 'NAME', 'LAST_NAME', 'EMAIL'])\n ->where('ACTIVE')", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Выбрать группы пользователя", "snippet": "Выбрать группы пользователя\n```php\n$users = \\Bitrix\\Main\\UserTable::query()\n ->setSelect(['ID', 'GROUPS.GROUP'])\n ->setLimit(1)\n ->fetchCollection()\n;\n\n/**\n * @var \\Bitrix\\Main\\EO_User $user\n */\nforeach ($users as $user)\n{\n fore", "page": "docs-cms-basics-users", "path": "/docs/cms-basics/users/", "title": "Пользователи"}, {"heading": "Группы пользователей", "snippet": "Группы пользователей\nГруппы объединяют учетные записи по правам доступа и настройкам безопасности. Пользователь может входить в одну или несколько групп.\n\nСписок групп пользователей расположен в административном разделе на странице *Настрой", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Как создать или изменить группу", "snippet": "Как создать или изменить группу\n1. Откройте страницу *Настройки > Пользователи > Группы пользователей.*\n\n2. Выберите действие:\n\n - создать новую группу — нажмите Добавить группу,\n\n - изменить существующую — выберите группу и нажмите И", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Вкладка Параметры", "snippet": "Вкладка Параметры\nНа вкладке Параметры задайте основные настройки группы.\n\n- Активна — отметьте опцию, чтобы группа работала. Если группа неактивна, все ее пользователи будут заблокированы.\n\n- Порядок сортировки — введите число, которое о", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Вкладка Безопасность", "snippet": "Вкладка Безопасность\nНа вкладке настройте параметры безопасности для пользователей группы.\n\n- Предопределенные настройки уровня безопасности — выберите один из уровней безопасности. Система автоматически заполнит поля значениями для выбран", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Вкладка Доступ", "snippet": "Вкладка Доступ\nНастройте уровни прав доступа к модулям системы.\n\n![](./_images/user-groups-21.png){width=626px height=291px}\n\n!!! tip \"Совет\"\n\n\n Подробнее читайте в статье [Права доступа](./../security/access-control).", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Пример создания группы", "snippet": "Пример создания группы\nСоздайте группу Редакторы новостей, чтобы ее участники добавляли, редактировали и удаляли новости.\n\n1. Откройте страницу *Настройки > Пользователи > Группы пользователей.*\n\n2. Нажмите Добавить группу.\n\n3. На вкладке П", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "API групп пользователей", "snippet": "API групп пользователей\nДля работы с группами пользователей предназначены:\n\n- класс `CGroup` — для базовых операций: создать, изменить или удалить группу,\n\n- классы `\\Bitrix\\Main\\GroupTable` и `\\Bitrix\\Main\\UserGroupTable`-- для выборки ", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Удалить группу", "snippet": "Удалить группу\n```php\n/**\n * @var \\CMain $APPLICATION\n */\n\n$isDeleted = CGroup::Delete($groupId);\nif (!$isDeleted)\n{\n $error = (string)$APPLICATION->GetException();\n if (empty($error))\n {\n $error = \"Не пытайтесь удалить груп", "page": "docs-cms-basics-user-groups", "path": "/docs/cms-basics/user-groups/", "title": "Группы пользователей"}, {"heading": "Хлебные крошки", "snippet": "Хлебные крошки\nХлебные крошки или цепочка навигации — это список ссылок, который показывает путь от главной страницы до текущей. Например, `Главная / Статьи / Статья о Bitrix Framework`. Крошки помогают пользователям ориентироваться в струк", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Как компоненты влияют на навигационную цепочку", "snippet": "Как компоненты влияют на навигационную цепочку\nНекоторые компоненты автоматически добавляют свои заголовки в цепочку. Например, компоненты `bitrix:news` и `bitrix:catalog` добавляют названия элементов:\n\n- `Главная / Новости / Как выбрать C", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Изменить название пункта", "snippet": "Изменить название пункта\nЧтобы изменить название пункта, нужно отредактировать заголовок раздела.\n\n1. Откройте свойства раздела одним из двух способов.\n\n - В публичной части сайта на административной панели нажмите *Изменить раздел*.\n\n ", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Добавить свой пункт в цепочку", "snippet": "Добавить свой пункт в цепочку\nЧтобы вручную добавить пункт в цепочку, в коде страницы вызовите метод `AddChainItem`.\n\n```php\nAddChainItem(\"Отзывы\", \"/ru/forum/list.php?FID=3\");\n?>\n```\n\nВ конец цепочки будет добавлена ссы", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Не отображаются заголовки страниц", "snippet": "Не отображаются заголовки страниц\nВ цепочке навигации отображаются только названия инфоблоков. Главная страница и заголовки других страниц не отображаются.\n\n**Решение**\n\n- Откройте свойства главной страницы. В поле *Не показывать навигацио", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Повторяются пункты в цепочке", "snippet": "Повторяются пункты в цепочке\nВ хлебных крошках название торгового каталога отображается дважды: `Главная / Магазин / Видеонаблюдение / Видеонаблюдение`.\n\n- Первая ссылка — `/catalog/video/`.\n\n- Вторая ссылка — `/catalog/video/section.php?", "page": "docs-cms-basics-breadcrumbs", "path": "/docs/cms-basics/breadcrumbs/", "title": "Хлебные крошки"}, {"heading": "Меню", "snippet": "Меню\nВ Bitrix Framework меню может быть статическим, динамическим или смешанным. Выбор меню зависит от частоты изменений структуры сайта и вида информации.\n\nСтатическое меню\nВ статическое меню пункты добавляют вручную. Каждый пункт связан с", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Смешанное меню", "snippet": "Смешанное меню\nСмешанное меню используют, когда нужно объединить разные виды информации. Часть пунктов формируется из инфоблока, часть добавляют вручную. Например, меню может состоять:\n\n- из перечня услуг компании — это динамическое меню,\n", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Структура меню", "snippet": "Структура меню\nМеню в Bitrix Framework состоит из двух основных частей.\n\n1. Файлов меню с информацией о пунктах: `.тип.menu.php` и `.тип.menu_ext.php`. Префикс `тип` — это тип меню, например, `top`, `left`.\n\n2. Шаблона, который определяет в", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Файл статического меню", "snippet": "Файл статического меню\nПункты статического меню описывают в файле `.тип.menu.php`. В нем можно использовать стандартные переменные.\n\n- `$aMenuLinks` — [массив с данными](./menu#%D0%BC%D0%B0%D1%81%D1%81%D0%B8%D0%B2-$amenulinks) о каждом пун", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Файл динамического меню", "snippet": "Файл динамического меню\nФайл `.тип.menu_ext.php` содержит PHP-код, который расширяет массив `$aMenuLinks` на основе данных из информационных блоков или других источников. Например, в файле `.тип.menu_ext.php` используют компонент `bitrix:me", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Массив \\$aMenuLinks", "snippet": "Массив \\$aMenuLinks\nМассив `$aMenuLinks` хранит пункты меню. Каждый пункт — это массив с пятью элементами.\n\n1. Название пункта.\n\n2. Ссылка на пункт.\n\n3. Массив дополнительных ссылок, которые влияют на подсветку пункта.\n\n4. Массив дополнител", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Как работает замена меню", "snippet": "Как работает замена меню\n- Статическое меню заменяет статическое.\n\n- Динамическое меню заменяет только другое динамическое.\n\n- Пустой файл `.тип.menu.php` переопределяет меню как пустое. Это приводит к отсутствию меню в разделе.\n\nКак раб", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Как отредактировать меню", "snippet": "Как отредактировать меню\nОткрыть меню для редактирования пунктов можно двумя способами.\n\n- **Через административный раздел**. В менеджере файлов откройте раздел с меню и нажмите Редактировать меню.\n\n ![](./_images/menu-8.png){width=630px", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Расширенный режим", "snippet": "Расширенный режим\nРасширенный режим содержит настройки упрощенного режима и имеет детальные настройки.\n\n- Тип меню — выберите тип меню.\n\n- Шаблон для меню — укажите путь к файлу `тип.menu_template.php` с шаблоном внешнего вида.\n\n- Назван", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Компоненты", "snippet": "Компоненты\nЧтобы отобразить меню на сайте, нужно подключить компоненты Меню `bitrix:menu` и Пункты меню `bitrix:menu.sections`.\n\n!!! tip \"Совет\"\n\n\n О том, как подключить компоненты, читайте в статье [Компоненты](./../framework/components", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Меню bitrix:menu", "snippet": "Меню bitrix:menu\nКомпонент Меню `bitrix:menu` можно разместить в шаблоне сайта или во включаемой области. Компонент получает данные для пунктов из файлов:\n\n- `.тип.menu.php` — для статического меню,\n\n- `.тип.menu_ext.php` — для динамическ", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Шаблоны меню", "snippet": "Шаблоны меню\nШаблон меню — это шаблон компонента `bitrix:menu`. Системные шаблоны расположены в папке `/bitrix/components/bitrix/menu/templates`.\n\nВы можете:\n\n- выбрать готовый шаблон в настройках компонента,\n\n- создать свой вариант,\n\n- ", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Как создать шаблон меню", "snippet": "Как создать шаблон меню\n1. Определите структуру HTML — решите, будет ли меню списком, таблицей или блоками.\n\n2. Создайте файл `template.php`-- используйте массив `$arResult` компонента `bitrix:menu`.\n\n3. Добавьте CSS-файлы — сделайте активн", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Как работает массив \\$arResult", "snippet": "Как работает массив \\$arResult\nКомпонент `bitrix:menu` преобразует массив `$aMenuLinks` в `$arResult`. Каждый пункт меню — это массив с параметрами.\n\n- `TEXT` — название пункта.\n\n- `LINK` — ссылка.\n\n- `SELECTED` — принимает `true`, если ", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Показ пунктов", "snippet": "Показ пунктов\nВ расширенном режиме редактирования меню можно задать условия видимости.\n\n1. Тип условия — `Для групп пользователей`,\n\n2. Условие — выберите нужную группу, например, `Администраторы`.\n\n![](./_images/menu-35.png){width=700px he", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Примеры создания меню", "snippet": "Примеры создания меню\nПримеры составлены на основе демонстрационного интернет-магазина и меню в нижней его части.\n\n![](./_images/menu-9.png){width=611px height=346px}\n\nПредварительные операции\n1. В корне сайта создайте раздел `test-menu`.\n\n", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Двухуровневое древовидное меню", "snippet": "Двухуровневое древовидное меню\n1. В настройках модуля Управление структурой добавьте новый тип меню — `submenu` Подменю.\n\n2. В нижней области раздела `test-menu` откройте параметры компонента Меню `bitrix:menu`\n\n3. В параметрах укажите след", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Многоуровневое древовидное меню", "snippet": "Многоуровневое древовидное меню\nСоздайте статическое четырехуровневое меню на основе [двухуровневого меню](./menu#%D0%B4%D0%B2%D1%83%D1%85%D1%83%D1%80%D0%BE%D0%B2%D0%BD%D0%B5%D0%B2%D0%BE%D0%B5-%D0%B4%D1%80%D0%B5%D0%B2%D0%BE%D0%B2%D0%B8%D0%B", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Выпадающее меню", "snippet": "Выпадающее меню\nВыпадающее меню показывает подпункты при наведении. Правила создания [аналогичны древовидному меню](./menu#%D0%B4%D1%80%D0%B5%D0%B2%D0%BE%D0%B2%D0%B8%D0%B4%D0%BD%D0%BE%D0%B5-%D0%BC%D0%B5%D0%BD%D1%8E).\n\n1. Убедитесь, что в си", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Выпадающее меню из разделов инфоблока", "snippet": "Выпадающее меню из разделов инфоблока\nДля разделов инфоблока можно создать динамическое меню и добавить его к [выпадающему меню](./menu#%D0%B2%D1%8B%D0%BF%D0%B0%D0%B4%D0%B0%D1%8E%D1%89%D0%B5%D0%B5-%D0%BC%D0%B5%D0%BD%D1%8E). Получится смешан", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Графическое меню", "snippet": "Графическое меню\nМожно создать меню, где каждый пункт — это изображение. Активный пункт будет отображаться с одной картинкой, неактивный — с другой. Если изображение не задано, будет использоваться изображение по умолчанию.\n\n1. Подготовьте ", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Примеры настроек меню", "snippet": "Примеры настроек меню\nВ Bitrix Framework меню можно настроить подсветку, добавить подсказки и изображения, указать права доступа.\n\nПодсветить ссылки\n1. В расширенном режиме редактирования меню заполните поле *Доп. ссылки для подсветки*.\n\n2.", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Показать пункт меню в разделе сайта", "snippet": "Показать пункт меню в разделе сайта\nВ расширенном режиме редактирования настройте условие.\n\n1. Тип условия — `Для папки и файла`.\n\n2. Условие — задайте путь к разделу.\n\n!!! warning \"Внимание\"\n\n\n Работает для статических страниц или стран", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Добавить подсказку для пунктов меню", "snippet": "Добавить подсказку для пунктов меню\n1. В расширенном режиме редактирования меню добавьте параметр:\n\n ```Plain text\n Название: A_TITLE\n Значение: текст подсказки\n ```\n\n2. В шаблоне меню\n\n ```php\n \">\n ```\n\n2. В CSS-файле укажите правила для смены изображений по языку.\n\n ```css\n .menu li.it", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Меню tree, которое не сворачивается при переходе", "snippet": "Меню tree, которое не сворачивается при переходе\nЕсли уровень вложенности меню меньше двух, выполните следующие действия:\n\n1. Скопируйте стандартный шаблон меню tree в шаблон сайта.\n\n2. В файле `template.php` замените `
  • ` н", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Скрыть боковое меню по свойству страницы", "snippet": "Скрыть боковое меню по свойству страницы\n1. В верхнюю часть шаблона `header.php` добавьте код:\n\n ```php\n $APPLICATION->ShowProperty('menu');\n ```\n\n2. Если для страницы нужно скрыть меню, в ее свойствах укажите:\n\n ```php\n $APPLICAT", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Ошибки и советы", "snippet": "Ошибки и советы\n| Ошибка | Совет |\n| ------ | ----- |\n| Меню не обновилось после изменений | Очистите кеш или отключите его временно |\n| Пункт не отображается | Проверьте условие отображения и права доступа |\n| Появилось лишнее меню | Удали", "page": "docs-cms-basics-menu", "path": "/docs/cms-basics/menu/", "title": "Меню"}, {"heading": "Постраничная навигация", "snippet": "Постраничная навигация\nПостраничная навигация позволяет не загружать все записи сразу, а показывать их частями — по 10, 15 или 50 на странице.\n\n![](./_images/page-navigation.png){width=647px height=380px}\n\nЧтобы добавить навигацию к записям", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Классы навигации", "snippet": "Классы навигации\n- `\\Bitrix\\Main\\UI\\PageNavigation` — работает с прямой навигацией,\n\n- `\\Bitrix\\Main\\UI\\ReversePageNavigation` — отвечает за обратную навигацию,\n\n- `\\Bitrix\\Main\\UI\\AdminPageNavigation` — создает навигацию в административ", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Выполнить запрос к базе данных", "snippet": "Выполнить запрос к базе данных\nВ запросе передайте данные с помощью методов:\n\n- `getLimit()` --максимальное количество записей,\n\n- `getOffset()` — позицию записи, с которой начинать выборку.\n\n```php\n$records = \\Bitrix\\Main\\UserTable::quer", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Как отобразить навигацию", "snippet": "Как отобразить навигацию\nЧтобы на странице отобразить ссылки, передайте объект навигации в компонент.\n\nКомпонент main.pagenavigation\nПодключите компонент `main.pagenavigation` и передайте объект навигации через `NAV_OBJECT`. Компонент вывед", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Компонент main.ui.grid", "snippet": "Компонент main.ui.grid\nЧтобы добавить навигацию в грид, передайте объект навигации в компонент `main.ui.grid`. Он выведет таблицу с колонками `HEADERS`, строками `ROWS` и постраничной навигацией `NAV_OBJECT`. Параметр `NAV_PARAMS` подключит", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Как кастомизировать шаблон", "snippet": "Как кастомизировать шаблон\nЧтобы создать собственный шаблон навигации, используйте методы объекта `\\Bitrix\\Main\\UI\\PageNavigation`:\n\n- `getRecordCount()` — возвращает число записей,\n\n- `getPageCount()` — возвращает число страниц,\n\n- `get", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Как сформировать URL с параметрами навигации", "snippet": "Как сформировать URL с параметрами навигации\nСсылки на нужные страницы можно сгенерировать вручную с помощью метода `addParams()`.\n\n```php\n/**\n * Получаем ссылку на текущую страницу с параметрами навигации\n * Оба формата поддерживаются Page", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Как работает навигация без COUNT", "snippet": "Как работает навигация без COUNT\n1. Запрашивайте на одну запись больше, чем нужно на странице.\n\n2. Если «лишняя» запись получена, следующая страница существует.\n\n3. Установите в навигацию приблизительное общее число записей: `позиция выборк", "page": "docs-cms-basics-page-navigation", "path": "/docs/cms-basics/page-navigation/", "title": "Постраничная навигация"}, {"heading": "Включаемые области", "snippet": "Включаемые области\nВключаемая область — это отдельный фрагмент страницы, который можно редактировать независимо от основного контента. С ее помощью можно добавить текст, изображения или компоненты в шаблон сайта.\n\nКак работают включаемые об", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Особенности включаемых областей", "snippet": "Особенности включаемых областей\n- Показ включаемых областей можно ограничить с помощью дополнительных условий в коде. Например, область можно вывести только на главной странице или только для авторизованных посетителей.\n\n- Включаемые обла", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Где показывать область", "snippet": "Где показывать область\nПараметр компонента *Показывать включаемую область* задает вариант отображения области.\n\n- `sect` — для раздела. Область отображается на всех страницах раздела. Если в компоненте включить опцию *Рекурсивное подключен", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Рекурсивное подключение файлов раздела", "snippet": "Рекурсивное подключение файлов раздела\nПоказ включаемых областей раздела зависит от опции *Рекурсивное подключение включаемых областей разделов*.\n\n- Рекурсивный режим — опция включена. Если в текущем разделе нет файла области, система буде", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Размещение файла включаемой области", "snippet": "Размещение файла включаемой области\nФайл включаемой области для раздела размещают в этом же разделе сайта. Для страницы — в той же директории, где расположена страница. Например, страница `article.php` находится в папке `/my-section/`, знач", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Создать файл в административной части", "snippet": "Создать файл в административной части\n1. Перейдите в раздел *Контент > Структура сайта > Файлы и папки*.\n\n2. В менеджере файлов откройте подходящую директорию.\n\n3. Нажмите Добавить файл.\n\n4. Укажите имя файла и суффикс из настроек компонент", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Как скрыть или удалить область", "snippet": "Как скрыть или удалить область\nВключаемую область можно скрыть одним из трех вариантов.\n\n- Очистить содержимое файла или удалить файл области.\n\n- В настройках компонента изменить значения параметров *Показывать включаемую область* или *Су", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Пример включаемой области", "snippet": "Пример включаемой области\n**Задача.** На сайте есть несколько разделов. Каждый раздел должен иметь свою верхнюю часть — шапку сайта.\n\n**Решение.** Чтобы верхняя часть изменялась при переходе по разделам, внесите изменения в шаблон сайта.\n\n1", "page": "docs-cms-basics-includes", "path": "/docs/cms-basics/includes/", "title": "Включаемые области"}, {"heading": "Пользовательские поля", "snippet": "Пользовательские поля\nС помощью пользовательских полей можно создать новые поля к объектам Bitrix Framework. Например, добавить дополнительные данные к пользователю, задаче, сделке.\n\nДля каждого объекта можно создать произвольное количество", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "В каких объектах доступны поля", "snippet": "В каких объектах доступны поля\nПользовательские поля работают с объектами системы. При создании поля следует указать один из объектов.\n\n??? info \"Список системных объектов\"\n\n\n #|\n || **Модуль** | **Объект** | **Назначение** | **Доступ", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Типы данных", "snippet": "Типы данных\nПользовательские поля можно создавать с различными типами данных: число, текст, дата и другие.\n\n| Код | Название | Примечание |\n| --- | -------- | ---------- |\n| `address` | Адрес |\n| `resourcebooking` | Бронирование ресурсов |\n", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Как создать поле через интерфейс", "snippet": "Как создать поле через интерфейс\nСоздайте пользовательское поле одним из двух способов.\n\n1. На странице *Настройки > Настройки продукта > Пользовательские поля* нажмите Добавить.\n\n ![](./_images/userfields.png){width=717px height=455px}\n\n", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Как задать настройки поля", "snippet": "Как задать настройки поля\nВ форме укажите следующие параметры:\n\n- Тип данных — выберите один из [типов данных](./userfields#типы-данных). Тип можно задать только для нового поля. Обязательный параметр.\n\n- Объект — укажите [код объекта](./", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Как работать с полями через API", "snippet": "Как работать с полями через API\nЗа работу с пользовательскими полями отвечают классы `CUserTypeEntity` в старом ядре и `UserField` в D7.\n\nКласс `UserFieldTable` применяют для простого доступа к существующим данным. Для изменения записей исп", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Пример создания поля типа Строка", "snippet": "Пример создания поля типа Строка\n```php\n$userTypeEntity = new CUserTypeEntity();\n\n$userFields = [\n // Идентификатор сущности, к которой будет привязано поле\n 'ENTITY_ID' => 'IBLOCK_3_SECTION',\n // Код поля, всегда должен начинаться", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Как добавить значение поля", "snippet": "Как добавить значение поля\nСпособ добавления значений зависит от типа пользовательского поля. Для большинства типов значение присваивается напрямую при создании или обновлении сущности.\n\nДля поля типа Список значения хранятся отдельно в таб", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Пример обновления поля", "snippet": "Пример обновления поля\nКод делает поле обязательным для заполнения.\n\n```php\n$userTypeEntity->Update($userFieldId, [\n 'MANDATORY' => 'Y',\n]);\n```\n\nКак обновить значения поля\nЧтобы обновить значения поля, используйте класс `CUserTypeManage", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Выборка, фильтрация и сортировка", "snippet": "Выборка, фильтрация и сортировка\nПользовательские поля можно использовать в ORM как обычные: выбирать, фильтровать, сортировать, обновлять. ORM подключит нужные таблицы и сохранит изменения.\n\nВ класс таблицы `MyTable` добавьте статический м", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Как добавить поле к любому объекту", "snippet": "Как добавить поле к любому объекту\nПользовательские поля можно добавить к любому объекту, который изначально их не поддерживает. Например, для объекта `BLOG_RATING` необходимо добавить поле `Рейтинг`.\n\n1. Создайте поле с помощью метода `Add", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "События", "snippet": "События\nДля работы с пользовательскими полями можно использовать события Главного модуля.\n\n- `OnUserTypeBuildList` — вызывается при построении списка пользовательских полей методом `CUserTypeManager::GetUserType`.\n\n- `OnUserTypeRightsChec", "page": "docs-cms-basics-userfields", "path": "/docs/cms-basics/userfields/", "title": "Пользовательские поля"}, {"heading": "Панель администрирования", "snippet": "Панель администрирования\nПанель администрирования — инструмент для работы с содержимым сайта, отображается в верхней части страницы после авторизации. Набор инструментов зависит от страницы и прав пользователя.\n\nС помощью панели администрир", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Как включить панель администрирования", "snippet": "Как включить панель администрирования\nВ 1С-Битрикс: Управление сайтом панель администрирования доступна для пользователей с правами на редактирование сайта.\n\nВ коробочной версии Битрикс24 панель скрыта по умолчанию для всех пользователей, н", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Основные части панели", "snippet": "Основные части панели\n![](./_images/admin-panel-6.png){width=1258px height=179px}\n\n1. Меню — выпадающее меню позволяет быстро перейти в любую часть административного раздела.\n\n2. Сайт — работа с публичной частью. Можно вносить изменения и с", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Описание элементов интерфейса", "snippet": "Описание элементов интерфейса\n![](./_images/admin-panel.jpeg){width=1280px height=133px}\n\n1. Создать страницу — добавляет новые страницы.\n\n2. Создать раздел — добавляет новый раздел.\n\n3. Меню — управляет навигацией.\n\n4. Структура — открыва", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Режим правки", "snippet": "Режим правки\n![](./_images/admin-panel-11.png){width=1258px height=179px}\n\nРежим правки — быстрый способ отредактировать элементы в публичном разделе сайта. Включите режим с помощью кнопки *Режим правки* и наведите курсор на нужную область,", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Область компонента", "snippet": "Область компонента\nВид панели будет зависеть от типа компонента. Например, чтобы изменить товар каталога:\n\n1. Наведите курсор на товар и нажмите *Изменить товар*.\n\n2. Внесите изменения и нажмите *Сохранить*.\n\n![](./_images/admin-panel-5.pn", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Подключить панель", "snippet": "Подключить панель\nКод для подключения административной панели задается в служебной области шаблона дизайна сайта сразу после тега ``.\n\n```php\nShowPanel();\n?>\n```\n\nПанель можно принудительно отображать для группы ил", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Добавить кнопки", "snippet": "Добавить кнопки\nЧтобы создать кнопки на панели управления, используйте код:\n\n```php\nAddPanelButton(\n [\n \"ID\" => \"button_id\", // Уникальный идентификатор кнопки\n \"TEXT\" => \"Название кнопки\",\n \"TYPE", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Добавить контекстное меню", "snippet": "Добавить контекстное меню\nЧтобы добавить пункты контекстного меню к любой кнопке, используйте код:\n\n```php\n$APPLICATION -> AddPanelButtonMenu($btnId, $arMenuItem)\n```\n\n- `$btnId` – идентификатор кнопки,\n\n- `$arMenuItem` – массив пунктов.\n", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Тулбар компонента", "snippet": "Тулбар компонента\nТулбар — это панель кнопок над компонентом. Здесь размещают:\n\n- основные действия на панели администрирования, например редактировать, добавить, удалить,\n\n- функции, которые часто используются.\n\nОстальные действия помеща", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Работа со списком элементов", "snippet": "Работа со списком элементов\nВ Bitrix Framework в модуле `main` доступны два класса для работы со списками элементов:\n\n- `CAdminList` — базовый класс для вывода списков элементов в интерфейсе административного раздела. Например, для отображ", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Режимы работы грида", "snippet": "Режимы работы грида\nГрид — это компонент для вывода данных в виде таблицы с поддержкой сортировки, фильтрации, редактирования и других действий без перезагрузки страницы. Поддерживает несколько режимов работы:\n\n- простой вывод списка элеме", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Вспомогательные методы", "snippet": "Вспомогательные методы\nЧтобы не писать большой объем кода для сравнения с константой, используйте вспомогательные методы:\n\n- `public function isPageMode(): bool` — вернет `true`, если страница с гридом открывается в браузере,\n\n- `public f", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Обработка inline-редактирования элементов", "snippet": "Обработка inline-редактирования элементов\nПозволяет пользователям изменять данные прямо в таблице без перезагрузки страницы.\n\nПример обработки:\n\n```php\n// Проверить, было ли отправлено inline-редактирование\nif ($lAdmin->EditAction())\n{\n ", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Групповые операции", "snippet": "Групповые операции\nГрупповые операции позволяют:\n\n- выполнять действия с несколькими элементами сразу,\n\n- обрабатывать данные списком,\n\n- упрощать массовые изменения.\n\nПример обработки:\n\n```php\n// Проверить наличие группового действия\nif", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Контекстное меню элементов списка", "snippet": "Контекстное меню элементов списка\n\nНастроить HTML-атрибут\nДобавьте `id` для блока, чтобы привязать контекстное меню:\n\n```php\n
    GetEditAreaId('edit_area_1') ?>\">\n \n
    \n```\n\nОпре", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Работа с кнопками", "snippet": "Работа с кнопками\n**Добавить кнопку**\n\nДобавить кнопку, которая открывает указанный URL в всплывающем окне:\n\n```php\n// Добавить кнопку редактирования с popup-окном\n$this->AddEditAction(\n 'edit_area_1', // Идентифика", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Административные страницы в публичной части", "snippet": "Административные страницы в публичной части\nАдминистративные страницы позволяют редактировать контент в публичной части сайта без перехода в административный раздел. Например, формы редактирования элементов инфоблоков.\n\nОткрыть страницу в p", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Кнопки управления для инфоблоков", "snippet": "Кнопки управления для инфоблоков\nМетод `GetPanelButtons` генерирует кнопки для работы с элементами и разделами инфоблока.\n\n```php\n// Получить HTML-код кнопок управления для инфоблока\n$buttons = CIBlock::GetPanelButtons(\n $iblockId = 5, ", "page": "docs-cms-basics-admin-panel", "path": "/docs/cms-basics/admin-panel/", "title": "Панель администрирования"}, {"heading": "Дата и время", "snippet": "Дата и время\nBitrix Framework работает с датой и временем с помощью двух классов:\n\n- `Bitrix\\Main\\Type\\Date` — для даты,\n\n- `Bitrix\\Main\\Type\\DateTime` — для даты и времени.\n\n```php\nuse Bitrix\\Main\\Type\\Date;\nuse Bitrix\\Main\\Type\\DateTime", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Формат вывода", "snippet": "Формат вывода\nКлассы `Date` и `DateTime` выводят дату в формате сайта. Задать формат можно при создании объекта. Если не указать формат, классы возьмут его из региональных настроек.\n\nРегиональные настройки хранит объект `Bitrix\\Main\\Context", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Преобразование формата", "snippet": "Преобразование формата\nКлассы используют метод `convertFormatToPhp`, чтобы преобразовать региональные настройки в формат PHP.\n\n| **Маска в настройках** | **Маска PHP** | **Описание** |\n|------------------------|--------", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Класс Date", "snippet": "Класс Date\nКласс `Bitrix\\Main\\Type\\Date` хранит только дату. Такой формат подходит для даты рождения, сроков акций или других событий без указания времени.\n\nСоздать объект даты\nКонструктор `new Date($time, $format)` создает объект даты. При", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Создать дату из объекта", "snippet": "Создать дату из объекта\nКласс `Date` предоставляет именованные конструкторы для создания объектов из разных источников.\n\n- `createFromPhp(\\DateTime $datetime)` — создает объект `Date` из объекта `\\DateTime`. Время сбрасывает в `00:00:00`.\n", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Методы", "snippet": "Методы\n\nФорматировать дату\nМетод `format($format)` форматирует дату по [маске PHP](https://www.php.net/manual/en/datetime.format.php).\n\n- `$format` — строка формата PHP.\n\n```php\nuse Bitrix\\Main\\Type\\Date;\n\n$date = new Date('2025-11-25', 'Y", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Изменить дату на интервал", "snippet": "Изменить дату на интервал\nМетод `add($interval)` изменяет дату на заданный интервал. Вызов метода изменяет и возвращает этот же объект.\n\n- `$interval` — строка интервала. Указать смещение можно словами `years`, `months`, `days`, `weeks`, `", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Получить метку времени timestamp", "snippet": "Получить метку времени timestamp\nМетод `getTimestamp()` возвращает метку времени `timestamp` для даты.\n\n```php\nuse Bitrix\\Main\\Type\\Date;\n\n$date = new Date('2025-11-25', 'Y-m-d');\necho $date->getTimestamp(); // 1742947200\n```\n\nПолучить инте", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Создать объект даты и времени", "snippet": "Создать объект даты и времени\nКонструктор создает объект даты со временем.\n\n```php\nnew DateTime(?string $time = null, ?string $format = null, ?DateTimeZone $timezone = null)\n```\n\n- `$time` — строка с датой и временем. По умолчанию — текуще", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Создать дату и время из объекта", "snippet": "Создать дату и время из объекта\nКласс `DateTime` предоставляет именованные конструкторы для создания объектов из разных источников.\n\n- `createFromPhp(\\DateTime $datetime)` — создает объект `DateTime` из стандартного объекта PHP `\\DateTime`", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Задать время", "snippet": "Задать время\nМетод `setTime($hour, $minute, $second = 0, $microseconds = 0)` задает время.\n\n```php\nuse Bitrix\\Main\\Type\\DateTime;\n\n$dt = new DateTime('2025-11-25', 'Y-m-d');\n$dt->setTime(9, 30);\necho $dt->format('d.m.Y H:i'); // 25.11.2025 ", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Настройка", "snippet": "Настройка\nНастроить часовые пояса можно в административном разделе на странице *Настройки > Настройки продукта > Настройки модулей > Главный модуль*.\n\n![](./_images/datetime.png){width=792px height=236px}\n\n- Локальное время сервера — показ", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Методы конвертации времени {#methods}", "snippet": "Методы конвертации времени {#methods}\nВ классе `DateTime` есть два метода для конвертации времени в нужный часовой пояс.\n\n- `createFromUserTime($timeString)` — создает объект Даты и времени в часовом поясе сервера из строки с датой и време", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Автоматический перевод времени", "snippet": "Автоматический перевод времени\nКласс `DateTime` автоматически переводит время в часовой пояс пользователя при преобразовании объекта в строку, если в настройках сайта включены часовые пояса.\n\n```php\nuse Bitrix\\Main\\Type\\DateTime;\n\n// Сервер", "page": "docs-advanced-datetime", "path": "/docs/advanced/datetime/", "title": "Дата и время"}, {"heading": "Локализация", "snippet": "Локализация\nЛокализация — это процесс адаптации интерфейса и данных системы под языковые и культурные особенности региона. В Bitrix Framework локализация включает управление языками интерфейса, региональными настройками и языковыми сообщени", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Добавить настройки", "snippet": "Добавить настройки\nНажмите кнопку *Добавить* на странице *Настройки > Настройки продукта > Языковые параметры > Региональные настройки*. Настройте две вкладки в форме создания.\n\n1. **Параметры.** Укажите основные параметры региона.\n\n ![](", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Добавить язык", "snippet": "Добавить язык\nНажмите кнопку *Добавить язык* и заполните поля в форме создания.\n\n![](./_images/localization-5.png){width=1232px height=933px}\n\n1. ID — идентификатор языка. Он должен совпадать с идентификатором языка в системе обновлений *Ma", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Создать языковые файлы", "snippet": "Создать языковые файлы\n1. Создайте папку `lang` в корне вашего проекта: шаблона, компонента, скрипта.\n\n2. Внутри создайте подпапки для каждого языка, например, `ru` и `en`.\n\n3. В каждой языковой папке создайте PHP-файлы для языковых сообщен", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Использовать языковые сообщения в PHP-коде", "snippet": "Использовать языковые сообщения в PHP-коде\nЧтобы связать PHP-код с языковыми файлами, используйте методы класса `Bitrix\\Main\\Localization\\Loc`:\n\n- `loadMessages()` — загрузить файл,\n\n- `getMessage()` — получить языковое сообщение.\n\nАвтома", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Подключить файл", "snippet": "Подключить файл\nМетод `loadMessages` подключает языковой файл. Укажите его в начале PHP-файла.\n\n!!! note \"Примечание\"\n\n\n Используйте метод для ручного подключения языковых файлов, когда автоматическая загрузка не применяется.\n\n\n\n```php\n<", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Получить языковое сообщение", "snippet": "Получить языковое сообщение\nМетод `getMessage` возвращает сообщение по коду.\n\n```php\nuse Bitrix\\Main\\Localization\\Loc;\n\nLoc::getMessage($code, $replace, $language)\n```\n\n- `$code` — код сообщения. Должен быть уникальным.\n\n- `$replace` — ма", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Влияние на производительность", "snippet": "Влияние на производительность\nЯдро Bitrix Framework использует механизм отложенной загрузки. Система загружает языковой файл в момент первого вызова `Loc::getMessage()` для фразы из этого файла. Это повышает производительность, когда сообще", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Получить региональные параметры", "snippet": "Получить региональные параметры\nКласс `\\Bitrix\\Main\\Context\\Culture` хранит региональные настройки: форматы даты, времени, имени, разделители чисел. Эти настройки класс берет из региональных параметров языка сайта.\n\nСистема автоматически со", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "JavaScript", "snippet": "JavaScript\nВ JavaScript-скриптах Bitrix Framework глобально доступна функция `BX.message`. Она предоставляет доступ к языковым сообщениям, которые система автоматически загружает на страницу. Использовать функцию можно двумя способами.\n\n1. ", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Компоненты BitrixVue 3", "snippet": "Компоненты BitrixVue 3\nДля приложений и компонентов, созданных на BitrixVue 3, локализация доступна через класс `$Bitrix.Loc`, который внедряется в экземпляр Vue.\n\nПолучить фразу по коду\nМетод `$Bitrix.Loc.getMessage(name, replacements)` во", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Получить все языковые фразы", "snippet": "Получить все языковые фразы\nМетод `$Bitrix.Loc.getMessages()` возвращает объект со всеми фразами, которые есть в текущем Vue-приложении.\n\n```javascript\n// Получить все фразы в компоненте\ncreated()\n{\n const allMessages = this.$Bitrix.Loc.", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Получить фразы по фильтру", "snippet": "Получить фразы по фильтру\nЕсли компонент использует сотни фраз, прямой вызов `getMessage()` в шаблоне может создать нагрузку. Для оптимизации используйте вычисляемое свойство с `BitrixVue.getFilteredPhrases()`.\n\nМетод `BitrixVue.getFiltered", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Инструменты для работы с переводами", "snippet": "Инструменты для работы с переводами\nДля удобства массового редактирования фраз и переноса локализаций между системами, в Bitrix Framework есть два инструмента.\n\n1. Экспорт и импорт через CSV.\n\n2. Сбор и загрузка пакетов локализации.\n\nЭкспор", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Сбор и загрузка пакетов локализации", "snippet": "Сбор и загрузка пакетов локализации\nВы можете создать полный пакет локализации для любого языка на странице *Настройки > Локализация > Выгрузка и загрузка.*\n\n![](./_images/localization-7.png){width=1235px height=576px}\n\nСобрать пакет перево", "page": "docs-advanced-localization", "path": "/docs/advanced/localization/", "title": "Локализация"}, {"heading": "Кодировка", "snippet": "Кодировка\nКодировка определяет, как система хранит и передает текстовые данные: содержимое страниц, языковые файлы, значения из базы данных, письма, файлы обмена и ответы API.\n\nПродукты Bitrix Framework работают в кодировке UTF-8.\n\nРанее пр", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как связаны настройки кодировки", "snippet": "Как связаны настройки кодировки\nВ Bitrix Framework за кодировку отвечают несколько уровней настроек. Они не заменяют друг друга, а проверяются и используются системой в разные моменты загрузки ядра.\n\nКодировка проекта складывается из настро", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как получить кодировку текущего контекста", "snippet": "Как получить кодировку текущего контекста\nПолучить объект `Culture` текущего контекста можно методом `getCulture()`.\n\n```php\ngetContext()->getCulture();\n$charset = $", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как настроить UTF-8 в проекте", "snippet": "Как настроить UTF-8 в проекте\nДля корректной работы проекта используйте UTF-8 в окружении, конфигурации, базе данных, файлах и обмене с внешними системами.\n\n!!! note \"Примечание\"\n\n\n Параметр `utf_mode` в `.settings.php` должен быть включ", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Конфигурация ядра", "snippet": "Конфигурация ядра\n- В `/bitrix/.settings.php` включена секция `'utf_mode' => ['value' => true, 'readonly' => true]`.\n\n- В текущем контексте `Application::getInstance()->getContext()->getCulture()->getCharset()` возвращает `UTF-8`.\n\n- В `", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как работать с файлами", "snippet": "Как работать с файлами\nСохраняйте исходники проекта в UTF-8 без BOM. Особенно проверяйте файлы, которые выполняются или подключаются как часть проекта:\n\n- PHP-файлы модулей, компонентов и обработчиков,\n\n- языковые файлы `/lang/<код языка>", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как работать с базой данных", "snippet": "Как работать с базой данных\nКодировка приложения и кодировка соединения с базой данных должны совпадать. Если PHP работает в UTF-8, а соединение с БД использует другую кодировку, текст может повредиться при чтении или записи.\n\nПроверяйте на", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Команды после подключения", "snippet": "Команды после подключения\nПосле установки соединения по умолчанию D7 ядро подключает файл `/bitrix/php_interface/after_connect_d7.php`, если в параметрах соединения не указан другой файл `include_after_connected`.\n\nВ этом файле могут быть S", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Как обновить сайт с однобайтовой кодировкой {#conversion-wizard}", "snippet": "Как обновить сайт с однобайтовой кодировкой {#conversion-wizard}\nПроекты с однобайтовой кодировкой нужно перевести в UTF-8, чтобы обновить Главный модуль `main` до версии 24.0.0 и выше.\n\nДля конвертации используйте мастер *Конвертация в utf", "page": "docs-advanced-encoding", "path": "/docs/advanced/encoding/", "title": "Кодировка"}, {"heading": "Отладка", "snippet": "Отладка\nИнструменты для отладки в Bitrix Framework помогают находить ошибки и проверять производительность сайта.\n\nОтладка в публичной части сайта\nЧтобы посмотреть статистику страницы в публичной части сайта, нажмите кнопку Отладка в панели", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Детальная статистика кеша", "snippet": "Детальная статистика кеша\nПоказывает объем данных, которые кешируются для страницы.\n\n1. Нажмите Отладка и в выпадающем меню выберите Детальная статистика кеша.\n\n2. Данные появятся в нижнем левом углу страницы.\n\n ![](./_images/debug-4.png)", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Время исполнения страницы", "snippet": "Время исполнения страницы\nПоказывает, за какое время сервер сгенерировал страницу.\n\n1. Нажмите Отладка и в выпадающем меню выберите Время исполнения страницы.\n\n2. Время выполнения отобразится в нижнем левом углу.\n\n ![](./_images/debug-7.p", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Как включить трекинг", "snippet": "Как включить трекинг\nПолучите объект соединения с базой данных и запустите трекер через метод `startTracker()`.\n\n```php\n// Получаем соединение с базой данных\n$connection = \\Bitrix\\Main\\Application::getConnection();\n\n// Включаем отслеживание", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Пример использования", "snippet": "Пример использования\nПроанализируем запросы, которые выполняются при получении списка активных пользователей.\n\n```php\n$connection = \\Bitrix\\Main\\Application::getConnection();\n\n$connection->startTracker();\n\n// Выполняем SQL-запрос к таблице ", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Как записать данные в файл", "snippet": "Как записать данные в файл\nКласс `Debug` предоставляет три основных метода для отладки:\n\n1. `writeToFile($var, $varName = \"\", $fileName = \"\")` — записывает значение переменной в файл. Для массивов используется функция `print_r()`, а для ост", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Как замерить время выполнения кода", "snippet": "Как замерить время выполнения кода\n1. Ограничьте участок кода методами `startTimeLabel()` и `endTimeLabel()` с одинаковой меткой.\n\n2. Выведите результаты всех замеров с помощью метода `getTimeLabels()`.\n\n```php\nuse Bitrix\\Main\\Diag\\Debug;\n\n", "page": "docs-advanced-debug", "path": "/docs/advanced/debug/", "title": "Отладка"}, {"heading": "Резервное копирование", "snippet": "Резервное копирование\nРезервная копия — это архив сайта в формате `tar.gz`, который может содержать файлы публичной части, ядро Bitrix Framework и дамп базы данных.\n\nРезервные копии нужны для защиты от потери данных и при переносе сайта на ", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Облако 1С-Битрикс", "snippet": "Облако 1С-Битрикс\nОблако 1С-Битрикс — бесплатное облачное хранилище с шифрованием и поддержкой автоматического резервного копирования.\n\nДля работы с облаком нужны активный коммерческий лицензионный ключ и установленный модуль Облако 1С-Битр", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Сторонние облачные хранилища", "snippet": "Сторонние облачные хранилища\nСторонние облачные хранилища подключают через модуль Облачные хранилища.\n\n1. Зарегистрируйте аккаунт у провайдера.\n\n2. Настройте подключение через интерфейс Bitrix Framework.\n\nОбъем хранилища зависит от тарифног", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Экспертные настройки {#expert}", "snippet": "Экспертные настройки {#expert}\nНа вкладке Параметры можно вручную задать настройки резервного копирования.\n\n1. Отметьте опцию *Включить экспертные настройки создания резервной копии*.\n\n ![](./_images/backup-2.png){width=683px height=329px", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Шифрование копий {#encrypt}", "snippet": "Шифрование копий {#encrypt}\nШифрование использует стандартный алгоритм `openssl_encrypt` и защищает данные в резервной копии.\n\nПри создании зашифрованной копии система запросит пароль. Рекомендуется использовать пароль длиной не менее 6 сим", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Уменьшить размер архива", "snippet": "Уменьшить размер архива\nБольшие архивы быстро заполняют место и усложняют восстановление. Размер архива можно сократить.\n\n- Не включайте в копию то, что можно пересоздать: поисковый индекс, статистику, журнал событий.\n\n- Исключите папку с", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Настроить автоматическое копирование", "snippet": "Настроить автоматическое копирование\nСоздание резервных копий можно настроить в автоматическом режиме с помощью скрипта. Без участия пользователя система делает копию один раз в день, через день, каждые три дня или один раз в неделю.\n\n1. От", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Методы запуска {#methods}", "snippet": "Методы запуска {#methods}\nСкрипт резервного копирования можно запустить одним из трех методов.\n\nЗапуск через облачный сервис\nСпособ подходит для небольших проектов. Он не требует настройки сервера — достаточно задать расписание: время созда", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Запуск через cron", "snippet": "Запуск через cron\nСпособ требует настройки `cron` на сервере. Скрипт `/bitrix/modules/main/tools/cron_events.php` должен запускаться каждую минуту.\n\nСначала скрипт обрабатывает почту и системные агенты. Если наступило время резервного копир", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Создать копию из командной строки", "snippet": "Создать копию из командной строки\nСоздайте резервную копию через терминал, если у вас есть доступ к серверу по SSH.\n\n!!! warning \"Внимание\"\n\n\n Команды запускают резервное копирование с настройками, которые заданы в административном разде", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Архивировать папку upload отдельно", "snippet": "Архивировать папку upload отдельно\nПапка `/upload` часто содержит много файлов. Архивируйте ее отдельно, чтобы не замедлять основное резервное копирование.\n\nПример команды:\n\n```bash prompt=\"$\"\n$ tar -czvf upload.tar.gz ./upload\n```\n\nВыполни", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Резервное копирование при многосайтовости", "snippet": "Резервное копирование при многосайтовости\nЕсли на одном ядре Bitrix Framework работает несколько сайтов, резервное копирование имеет особенности.\n\n- В архив можно включить любые сайты. На странице *Настройки > Инструменты > Резервное копир", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Административный раздел", "snippet": "Административный раздел\nСпособ подходит, если можно зайти в панель управления.\n\n1. Перейдите в *Настройки > Инструменты > Резервное копирование > Список резервных копий*.\n\n2. Найдите нужную копию и в меню выберите Восстановить.\n\n ![](./_", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Облачная копия", "snippet": "Облачная копия\nДля облачной копии система предложит выбрать источник:\n\n- развернуть копию из облака 1С-Битрикс — укажите лицензионный ключ, архив и пароль,\n\n- скачать по ссылке с другого сайта — получите ссылку на странице *Настройки > Ин", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Модули Маркетплейс", "snippet": "Модули Маркетплейс\nЕсли восстанавливаете сайт из копии, которая сделана до установки модуля, в архиве модуль отсутствует. Его можно установить повторно, если не истек период подписки.\n\nНекоторые модули сохраняют данные в базе сайта. Чтобы н", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Восстановить отдельные файлы", "snippet": "Восстановить отдельные файлы\n!!! warning \"Внимание\"\n\n\n Способ работает только с локальными архивами без шифрования.\n\n\n\nАрхив `backup.tar.gz` — это обычный файл, который можно распаковать вручную, как любой архив.\n\nВ операционных система", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Архив поврежден", "snippet": "Архив поврежден\n**Ошибка.** Archive is corrupted, wrong block: 0.\n\n**Причины.** Не хватает места или памяти на сервере, ограничения хостинга, сбой при создании архива.\n\n**Решение.** Проверьте свободное место и лимиты. Если проблема сохраняе", "page": "docs-advanced-backup", "path": "/docs/advanced/backup/", "title": "Резервное копирование"}, {"heading": "Монитор качества", "snippet": "Монитор качества\nМонитор качества помогает проверить проект на Битрикс перед сдачей заказчику или запуском в работу. Инструмент содержит чек-лист автоматизированных и ручных тестов для проверки веб-окружения, интеграции дизайна, безопасност", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Сценарии использования", "snippet": "Сценарии использования\nМонитор качества можно использовать в нескольких рабочих сценариях.\n\n**Перед запуском проекта.** Разработчик проходит обязательные тесты, исправляет найденные проблемы и показывает заказчику отчет в административном р", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Открыть инструмент", "snippet": "Открыть инструмент\nИнструмент находится в административном разделе продукта на странице *Настройки > Инструменты > Монитор качества*. При первом открытии система показывает вводную информацию об инструменте.\n\n![](./_images/quality-monitor.p", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Проверить проект", "snippet": "Проверить проект\n1. Откройте страницу *Настройки > Инструменты > Монитор качества*.\n\n2. Запустите проверку кнопкой *Начать тестирование*. Система соберет данные и выполнит автоматизированные тесты.\n\n3. Исправьте найденные проблемы в не прой", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Исправить не пройденный тест", "snippet": "Исправить не пройденный тест\nЕсли тест не пройден, система выделит его красным цветом. Чтобы открыть подробный отчет, нажмите на название теста. В отчете указаны причины, из-за которых система не засчитала проверку.\n\n- На вкладке *Рекомен", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Сохранить отчет", "snippet": "Сохранить отчет\nПосле успешного прохождения проверки, система сохраняет отчет в архив. В архиве можно посмотреть итоговый статус проверки, дату отчета и подробности по каждому тесту, включая системные сообщения автоматизированных тестов.\n\n!", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Дополнить чек-лист своими тестами", "snippet": "Дополнить чек-лист своими тестами\nРазработчик может добавить собственные разделы или тесты через событие главного модуля `OnCheckListGet`. Собственные тесты используют, когда в штатном чек-листе не хватает проверок для конкретного проекта. ", "page": "docs-advanced-quality-monitor", "path": "/docs/advanced/quality-monitor/", "title": "Монитор качества"}, {"heading": "Vue.js", "snippet": "Vue.js\nVue.js — это JavaScript-фреймворк для создания пользовательских интерфейсов. Он предназначен для разработки динамических веб-приложений. В основе фреймворка — реактивность и компонентный подход.\n\nBitrix Framework предоставляет специа", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Расширение BitrixVue", "snippet": "Расширение BitrixVue\nBitrixVue 3 — расширение библиотеки Vue.js 3. Оно полностью совместимо с оригинальным Vue 3 и добавляет инструменты для работы с Bitrix Framework. Возможности BitrixVue 3 доступны с версии модуля ui 22.100.0.\n\n!!! warn", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Подсказки в IDE", "snippet": "Подсказки в IDE\nДля автокомплита в модуле `UI` есть файл определений типов `ui.vue3.d.ts`.\n\n```\n/bitrix/modules/ui/install/js/ui/vue3/ui.vue3.d.ts\n```\n\nФайл содержит:\n\n- все методы для создания и управления приложением,\n\n- классы для инте", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Подключить BitrixVue 3", "snippet": "Подключить BitrixVue 3\nBitrixVue 3 можно подключить двумя способами, в зависимости от того, работаете ли вы с расширениями extensions или пишете js-код прямо на PHP-странице.\n\n**Extensions.** Предпочтительный способ организации JavaScript-к", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Создать Vue-приложение", "snippet": "Создать Vue-приложение\nМетод `BitrixVue.createApp(rootComponent, rootProps?)` создает экземпляр Vue-приложения.\n\n- `rootComponent` — объект, обязательный. Конфигурация корневого компонента: `data`, `methods`, `template` и так далее.\n\n- `r", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Структура приложения", "snippet": "Структура приложения\nВ реальном проекте используйте контроллер — специальный класс для управления Vue-приложением. Он связывает страницу с компонентами. Контроллер хранит бизнес-логику и управляет жизненным циклом приложения. Компоненты отв", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Компоненты", "snippet": "Компоненты\nBitrixVue поддерживает два типа компонентов.\n\n1. Классические компоненты Vue — на основе простых объектов без специальной обработки.\n\n ```javascript\n export const MyComponent = {\n template: '
    Classic
    '\n };\n ", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Порядок свойств в компоненте", "snippet": "Порядок свойств в компоненте\nВ сообществе Vue используют [единый порядок свойств](https://vuejs.org/style-guide/rules-recommended.html#component-instance-options-order) в компонентах. Этот порядок помогает быстро понимать код.\n\nСледуйте ему", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Пример классического компонента", "snippet": "Пример классического компонента\nПример показывает классический Vue-компонент. Он использует:\n\n- локальные события `emits`,\n\n- глобальные события `$Bitrix.eventEmitter`,\n\n- локализацию `$Bitrix.Loc.getMessage`.\n\n```javascript\nimport {Bit", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Мутация компонента", "snippet": "Мутация компонента\nПоведение существующего мутабельного компонента можно изменить методом `BitrixVue.mutateComponent`.\n\n```javascript\nBitrixVue.mutateComponent(source, mutations): boolean\n```\n\n- `source` — имя компонента или ссылка на объ", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Плейсхолдеры для шаблонов", "snippet": "Плейсхолдеры для шаблонов\nЧтобы расширить, а не заменить исходный шаблон, используйте плейсхолдер `#PARENT_TEMPLATE#`.\n\n```javascript\n// Добавим красную рамку вокруг оригинального содержимого компонента 'ui-digits'\nBitrixVue.mutateComponent", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Мутация свойств props и watch", "snippet": "Мутация свойств props и watch\nСвойство `props` может быть массивом или объектом. Если типы не совпали, BitrixVue сконвертирует `props` в объект.\n\nВ `watch` используйте префикс `parentWatch`, а не `parent`. Это правило помогает BitrixVue изб", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Клонирование компонентов", "snippet": "Клонирование компонентов\nКлонирование создает новый компонент на основе существующего с внесенными изменениями. В отличие от мутации, клон — это отдельный компонент. Клонировать можно и BitrixVue, и обычные Vue-компоненты. В BitrixVue 3 кло", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Отложенная загрузка компонентов", "snippet": "Отложенная загрузка компонентов\nЧтобы ускорить загрузку приложения, подключайте тяжелые компоненты по необходимости. Используйте метод `BitrixVue.defineAsyncComponent`.\n\n```javascript\nBitrixVue.defineAsyncComponent(extension, componentExpor", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Директивы", "snippet": "Директивы\nДирективы — это специальные атрибуты Vue, которые позволяют напрямую работать с DOM. Используйте их для простых задач, например, для установки фокуса или добавления поведения при наведении. Для сложного переиспользуемого интерфейс", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Интеграция с Bitrix Framework", "snippet": "Интеграция с Bitrix Framework\nВсе интеграционные методы Bitrix Framework доступны в компонентах через глобальную переменную `$Bitrix`. Это единая точка доступа к локализациям, событиям, данным и системным клиентам.\n\n- В шаблоне, computed, ", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Локализация \\$Bitrix.Loc", "snippet": "Локализация \\$Bitrix.Loc\nИспользуйте `$Bitrix.Loc.getMessage` для вывода языковых фраз.\n\n```javascript\n// В шаблоне\ntemplate: `
    {{ $Bitrix.Loc.getMessage('GREETING') }}
    `\n\n// С заменой плейсхолдеров (реактивно)\ntemplate: `
    {{ $", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "События приложения \\$Bitrix.eventEmitter", "snippet": "События приложения \\$Bitrix.eventEmitter\nОбменивайтесь событиями между любыми компонентами одного приложения.\n\n```javascript\n// Отправка события\nthis.$Bitrix.eventEmitter.emit('module:component:action', { foo: 'bar' });\n\n// Подписка на собы", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Общие данные \\$Bitrix.Data", "snippet": "Общие данные \\$Bitrix.Data\nКласс сохраняет произвольные данные в контексте Vue-приложения и получает их из компонента любого уровня вложенности. Позволяет организовать взаимодействие между компонентами без сложной системы синхронизации.\n\n!!", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "REST и Push-клиенты", "snippet": "REST и Push-клиенты\nДля внешних виджетов, например онлайн-форм или виджетов чата, которые работают за пределами продуктов Bitrix Framework, используйте классы `$Bitrix.RestClient` и `$Bitrix.PullClient`.\n\nВо всех остальных случаях используй", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Работа с событиями в BitrixVue", "snippet": "Работа с событиями в BitrixVue\nВ рамках приложений BitrixVue 3 можно работать с тремя уровнями событийной модели.\n\n1. Уровень компонентов — стандартные события Vue. Используйте для связи между родителем и прямым потомком.\n\n ```javascript\n", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Роутинг для внешних сайтов VueRouter", "snippet": "Роутинг для внешних сайтов VueRouter\nДля создания одностраничных приложений (SPA) с маршрутизацией используйте [официальную библиотеку Vue Router](https://router.vuejs.org/introduction.html). Подключите расширение `ui.vue3.router`.\n\n```java", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Централизованное хранение данных", "snippet": "Централизованное хранение данных\nВ небольших приложениях данные можно хранить внутри компонентов. Когда приложение разрастается, управлять состоянием становится сложнее: данные дублируются, синхронизация требует передачи событий через цепоч", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Pinia", "snippet": "Pinia\nДля работы с Pinia подключите расширение `ui.vue3.pinia`. Сначала создайте экземпляр хранилища с помощью `createPinia`. Затем определите само хранилище через `defineStore`, задав уникальное имя и описав состояние, геттеры и действия.\n", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Vuex", "snippet": "Vuex\nДля работы с Vuex подключите расширение `ui.vue3.vuex`. Создайте хранилище с помощью `createStore`, определив состояние, мутации и действия.\n\n```javascript\nimport {BitrixVue} from 'ui.vue3';\nimport {createStore} from 'ui.vue3.vuex';\n\nc", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Интеграция с Dexie (IndexedDB)", "snippet": "Интеграция с Dexie (IndexedDB)\nДля работы с локальной базой данных IndexedDB в BitrixVue используйте расширение `ui.dexie`. Оно предоставляет интеграцию с библиотекой Dexie, начиная с версии модуля ui 22.500.0.\n\nПодключите расширения `ui.de", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Teleport: Перемещение части шаблона", "snippet": "Teleport: Перемещение части шаблона\nКомпонент `` позволяет отрисовать часть шаблона компонента в другом месте DOM-дерева, вне текущего Vue-приложения. Это полезно для создания модальных окон, всплывающих подсказок или уведомлений,", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Внешние библиотеки", "snippet": "Внешние библиотеки\nЧтобы использовать внешнюю библиотеку, соберите ее как Bitrix JS Extension.\n\n1. Найдите ESM-версию библиотеки.\n\n2. Удалите лишние импорты и добавьте зависимости от модулей Bitrix, например, `import {...} from 'ui.vue3'`.\n", "page": "docs-advanced-vue", "path": "/docs/advanced/vue/", "title": "Vue.js"}, {"heading": "Многосайтовость", "snippet": "Многосайтовость\nBitrix Framework позволяет запускать несколько сайтов на одной установке. Сайты размещают в подпапках одного домена или на разных доменах.\n\nМногосайтовость подходит для управления отдельными, но связанными проектами. Все сай", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Когда использовать многосайтовость", "snippet": "Когда использовать многосайтовость\nПри создании нескольких сайтов выберите архитектуру: многосайтовость или отдельные установки.\n\nМногосайтовость подходит:\n\n- когда все сайты обслуживает одна команда разработки и администрирования,\n\n- сай", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "По доменному имени", "snippet": "По доменному имени\nПри запросе система сравнивает домен из адресной строки браузера с доменами, которые указаны в настройках сайтов.\n\nЕсли указали `site.ru`, система считает принадлежащими этому сайту все поддомены: `www.site.ru`, `docs.sit", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "По папке сайта", "snippet": "По папке сайта\nЕсли доменные имена не указаны или совпадают у нескольких сайтов, система выбирает сайт по пути в адресе страницы.\n\nВ поле Папка сайта задайте путь относительно корня сайта: `/`, `/ru/`, `/shop/`. Это не путь в файловой систе", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить многосайтовость", "snippet": "Настроить многосайтовость\nBitrix Framework поддерживает два режима многосайтовости.\n\n- На одном домене — сайты разделяют по подкаталогам, чтобы структура файлов не пересекалась. Каждый сайт размещают в отдельном подкаталоге внутри корневог", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Сравнить режимы", "snippet": "Сравнить режимы\nВыбор зависит от структуры проекта и возможностей хостинга. Таблица помогает оценить различия по ключевым параметрам.\n\n#|\n|| **Критерий** | **На одном домене** | **На разных доменах** ||\n|| URL-структура | `example.ru/`, `ex", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Создать папки для сайтов", "snippet": "Создать папки для сайтов\n1. Создайте общий корневой каталог, например, `/var/www/bx-sites/`.\n\n2. Установите Bitrix Framework в этот каталог.\n\n3. Создайте подпапку для второго сайта — `/var/www/bx-sites/shop/`.\n\n4. Поместите публичные файлы ", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить сайты в административном разделе", "snippet": "Настроить сайты в административном разделе\n1. Откройте страницу *Настройки > Настройки продукта > Сайты > Список сайтов*.\n\n2. Отредактируйте сайт, который создали при установке продукта. Проверьте настройки:\n\n - Папка сайта — `/`,\n\n - ", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить веб-сервер Apache", "snippet": "Настроить веб-сервер Apache\nУбедитесь, что в конфигурационном файле `httpd.conf` веб-сервера Apache настроен один виртуальный хост:\n\n```apache\n\n DocumentRoot \"/var/www/bx-sites\"\n ServerName example.ru\n ServerAlias", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить сайты", "snippet": "Настроить сайты\n1. Откройте страницу *Настройки > Настройки продукта > Сайты > Список сайтов*.\n\n2. Отредактируйте основной сайт, который создали при установке продукта. Проверьте настройки:\n\n - Папка сайта — `/`,\n\n - Доменное имя — `c", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Добавить символические ссылки", "snippet": "Добавить символические ссылки\nЧтобы сайты на разных доменах использовали общее ядро, настройте символические ссылки. Это специальные файлы, которые указывают на фактическое расположение папок.\n\n!!! warning \"Внимание\"\n\n\n Не копируйте папк", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Добавить служебные файлы", "snippet": "Добавить служебные файлы\nВ корень второго сайта `/var/www/site-shop/` добавьте следующие файлы:\n\n- `.htaccess` — управляет маршрутизацией, правилами доступа и настройками сервера. Без него страницы сайта могут не открываться или возвращать", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить виртуальные хосты", "snippet": "Настроить виртуальные хосты\nДобавьте настройки виртуальных хостов в конфигурационный файл Apache `httpd.conf`.\n\n1. Укажите для каждого сайта собственный `DocumentRoot`.\n\n2. Задайте основной домен в параметре `ServerName`.\n\n3. Добавьте `Serv", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить сортировку сайтов", "snippet": "Настроить сортировку сайтов\nЕсли один сайт работает на поддомене другого, укажите для поддомена меньшее значение сортировки. Это гарантирует, что при запросе к поддомену откроется второй сайт, а не основной.\n\nПримеры значений сортировки:\n\n-", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Как объекты зависят от сайтов", "snippet": "Как объекты зависят от сайтов\nВ многосайтовой системе одни данные общие для всех сайтов, другие принадлежат только одному. Учитывайте это при проектировании структуры или переносе данных.\n\nПримеры данных, которые всегда привязаны к конкретн", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Учитывать контекст сайта в агентах", "snippet": "Учитывать контекст сайта в агентах\nАгенты общие для всей установки. Система хранит их в единой базе данных и запускает из общего списка без автоматической фильтрации по текущему сайту. Агент не запускается отдельно для каждого сайта и не по", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Обеспечить сквозную идентификацию пользователей", "snippet": "Обеспечить сквозную идентификацию пользователей\nКогда посетитель заходит на один сайт многосайтовой системы, он получает идентификаторы для статистики, корзины, авторизации и других модулей. Данные сохраняются в cookie, которые привязаны к ", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Решить проблему дублирования PHPSESSID", "snippet": "Решить проблему дублирования PHPSESSID\nBitrix Framework не поддерживает размещение независимых установок на поддоменах одного родительского домена. Например:\n\n- `site.ru` — первая установка с 1С-Битрикс: Управление сайтом,\n\n- `crm.site.ru", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить установки без многосайтовости", "snippet": "Настроить установки без многосайтовости\nЕсли каждая установка содержит только один сайт и не требует сквозной авторизации между поддоменами, очистите поле Доменное имя в настройках `site.ru`.\n\n1. Перейдите на страницу *Настройки > Настройки", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить установки с многосайтовостью", "snippet": "Настроить установки с многосайтовостью\nЕсли одна из установок использует многосайтовость на разных доменах, поле Доменное имя оставьте заполненным. Система на его основе обеспечивает сквозную авторизацию между сайтами одной установки.\n\nВ эт", "page": "docs-advanced-multisite", "path": "/docs/advanced/multisite/", "title": "Многосайтовость"}, {"heading": "Настроить веб-сервер", "snippet": "Настроить веб-сервер\n1. Создайте отдельную папку для поддомена — `/var/www/forum/`.\n\n2. Настройте виртуальный хост Apache.\n\n ```apache\n \n ServerName forum.example.ru\n DocumentRoot \"/var/www/forum\"\n getInfo();\necho $info->getWidth(); // ширина\n```\n\nМетод `getInfo()` возвращает объект `Bitrix\\Main\\File\\Image\\Info", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "3\\. Загрузить изображение", "snippet": "3\\. Загрузить изображение\nВызовите метод `load()`, чтобы загрузить изображение в память:\n\n```php\nif ($image->load())\n{\n // изображение успешно загружено и готово к обработке\n}\n```\n\nЕсли файл поврежден или превышает лимит `maxSize`, метод", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "Подготовить параметры", "snippet": "Подготовить параметры\nДля работы с методами обработки используйте дополнительные классы:\n\n- `Bitrix\\Main\\File\\Image\\Color` — задает цвет в формате RGBA,\n\n- `Bitrix\\Main\\File\\Image\\Rectangle` — описывает область изображения: ширину, высоту", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "Изменить размер изображения", "snippet": "Изменить размер изображения\n```php\nuse Bitrix\\Main\\File\\Image;\nuse Bitrix\\Main\\File\\Image\\Rectangle;\n\n$image = new Image('/home/bitrix/www/sticker.gif');\n\nif ($image->load())\n{\n // Исходный прямоугольник по текущим размерам изображения\n ", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "Применить фильтр резкости", "snippet": "Применить фильтр резкости\n```php\nuse Bitrix\\Main\\File\\Image;\nuse Bitrix\\Main\\File\\Image\\Mask;\n\n$image = new Image('/home/bitrix/www/sticker.gif');\n\nif ($image->load())\n{\n $image->filter(Mask::createSharpen(15));\n}\n```\n\nФильтр `createShar", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "Сохранить изображение", "snippet": "Сохранить изображение\nПосле обработки сохраните результат с помощью метода `saveAs()` или `save()`.\n\nМетод `saveAs()` принимает три параметра:\n\n- `$file` — путь к файлу, куда сохранить изображение,\n\n- `$quality` — качество сжатия от `1` д", "page": "docs-advanced-images", "path": "/docs/advanced/images/", "title": "Работа с изображениями"}, {"heading": "HTTP-клиент", "snippet": "HTTP-клиент\nВ ядре Bitrix Framework есть встроенный HTTP-клиент, который отправляет запросы к внешним сервисам. Это класс `\\Bitrix\\Main\\Web\\HttpClient`. Он поддерживает два режима работы: упрощенный legacy и стандартный PSR-18.\n\nИспользуйте", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Задать параметры HTTP-клиента по умолчанию", "snippet": "Задать параметры HTTP-клиента по умолчанию\nЗадайте значения по умолчанию в файле `/bitrix/.settings.php`, чтобы не передавать параметры при каждом создании клиента.\n\nКлиент `HttpClient` принимает следующие параметры: таймауты, настройки про", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Legacy-режим", "snippet": "Legacy-режим\nLegacy-режим использует готовые методы: `get()`, `post()`, `download()` и другие. Эти методы упрощают работу с HTTP — не нужно вручную собирать запрос и обрабатывать потоки. Достаточно вызвать один метод с нужными параметрами.\n", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Скачать файл", "snippet": "Скачать файл\nПередайте URL файла и абсолютный путь к месту сохранения. По умолчанию используется метод GET.\n\n```php\nuse Bitrix\\Main\\Web\\HttpClient;\n\n$httpClient = new HttpClient();\n$httpClient->download(\n 'http://www.example.ru/robots.tx", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Отправить JSON-данные методом POST", "snippet": "Отправить JSON-данные методом POST\nДля отправки JSON укажите заголовок `Content-Type: application/json` и передайте тело как JSON-строку.\n\n```php\nuse Bitrix\\Main\\Web\\HttpClient;\n\n$httpClient = new HttpClient();\n$httpClient->setHeader('Conte", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Условное чтение тела ответа", "snippet": "Условное чтение тела ответа\nС версии 23.300.0 главного модуля можно динамически управлять чтением тела ответа вместо использования параметра `waitResponse`.\n\n1. Укажите callback-функцию в методе `shouldFetchBody()`. Функция получит объект о", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Стандарт PSR-18", "snippet": "Стандарт PSR-18\nPSR-18 — это стандарт PHP-FIG для HTTP-клиентов. Он определяет единый способ отправки запросов и обработки ответов.\n\nИнтерфейс `\\Psr\\Http\\Client\\ClientInterface` содержит один метод для отправки HTTP-запроса:\n\n```php\ninterfa", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Отправить POST-запрос с данными формы", "snippet": "Отправить POST-запрос с данными формы\n1. Создайте объект URI с полным URI конечной точки: протокол, хост и путь к скрипту.\n\n2. Подготовьте данные формы в виде ассоциативного массива.\n\n3. Преобразуйте массив в строку и запишите ее в поток `S", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Отправить файл методом POST", "snippet": "Отправить файл методом POST\nЧтобы отправить файл на сервер, выполните четыре действия.\n\n1. Откройте файл как ресурс с помощью `fopen()`.\n\n2. Передайте файл в теле запроса. Клиент автоматически оформит запрос в формате `multipart/form-data`.", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Обработать редиректы вручную", "snippet": "Обработать редиректы вручную\nКогда сервер отвечает кодом `301` или `302`, он указывает новый адрес в заголовке `Location`.\n\nВ режиме PSR-18 клиент не переходит по новому адресу. Он возвращает исходный ответ от сервера с кодом и заголовком `", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Асинхронные запросы", "snippet": "Асинхронные запросы\nОбычные HTTP-запросы выполняются синхронно и последовательно: клиент отправляет первый запрос, ждет ответ, затем отправляет следующий и так далее. Общее время складывается из всех задержек.\n\nАсинхронные запросы отправляю", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Получить ответы без контроля порядка", "snippet": "Получить ответы без контроля порядка\nДобавьте все запросы в очередь с помощью `sendAsyncRequest()`. Затем вызовите метод `wait()`. Он выполнит все запросы из очереди и вернет ответы в порядке их получения — самый быстрый ответ окажется перв", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Сохранить порядок запросов с помощью объектов Promise", "snippet": "Сохранить порядок запросов с помощью объектов Promise\nЧтобы сохранить соответствие между исходным списком URL и результатами, сохраните объекты `Promise` в массив и обработайте их по порядку.\n\nКаждый вызов `wait()` на объекте `Promise` возв", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Отреагировать на результаты через callback-функции", "snippet": "Отреагировать на результаты через callback-функции\nНазначьте callback-функцию, чтобы обработать ответ сразу после его получения. Для этого используйте метод `then()` объекта `Promise`.\n\nПервая callback-функция получает успешный ответ. Втора", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Настроить прокси", "snippet": "Настроить прокси\nЕсли запросы к внешним сервисам нужно отправлять через прокси-сервер, при создании клиента укажите хост и порт прокси. Для аутентификации добавьте логин и пароль.\n\n```php\n$http = new HttpClient([\n 'proxyHost' => '185.135", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Использовать cURL", "snippet": "Использовать cURL\nПо умолчанию клиент работает через PHP-сокеты. С версии PHP 8.0 можно подключить библиотеку cURL. Она работает быстрее, особенно при множественных или асинхронных запросах.\n\nВключите cURL с помощью параметра `useCurl => tr", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Настроить запросы через события", "snippet": "Настроить запросы через события\nСобытие `OnHttpClientBuildRequest` доступно с версии 23.800.0 главного модуля. Оно срабатывает перед каждым запросом, который отправляет `HttpClient` в рамках одного скрипта — после создания объекта запроса, ", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Настроить журналирование запросов", "snippet": "Настроить журналирование запросов\nКлиент поддерживает стандарт PSR-3. Рекомендуется настраивать логи в файле `.settings.php`.\n\n!!! tip \"Совет\"\n\n\n Подробную информацию читайте в статье [Логгеры](./logger.md).\n\nЗаписать каждый запрос в отд", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Записать только URL внешних обращений", "snippet": "Записать только URL внешних обращений\nИспользуйте кастомный форматтер, чтобы зафиксировать факт обращения к внешнему ресурсу. Он запишет только URL запроса и текущий URI страницы.\n\n```php\nreturn [\n 'loggers' => [\n 'value' => [\n ", "page": "docs-advanced-http-client", "path": "/docs/advanced/http-client/", "title": "HTTP-клиент"}, {"heading": "Геолокация", "snippet": "Геолокация\nГеолокация позволяет определить страну, город и другие данные о посетителе по его IP-адресу. Данные можно использовать для персонализации контента, оформления заказа и региональных настроек.\n\nВ Bitrix Framework геолокация работае", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Подключить геолокацию", "snippet": "Подключить геолокацию\nЧтобы подключить геолокацию, выполните следующие действия:\n\n1. Откройте страницу *Настройки > Настройки продукта > Геолокация*.\n\n2. Выберите обработчик и дважды кликните по строке или в меню нажмите Редактировать.\n\n ", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Параметры Sypex Geo", "snippet": "Параметры Sypex Geo\nВ поле Ключ укажите строку, которую получили после регистрации на сайте Sypex Geo. Если не превышаете бесплатный лимит, поле можно оставить пустым.\n\nДобавить свой обработчик\nЧтобы подключить собственный источник геоданны", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Страна", "snippet": "Страна\n```php\necho \\Bitrix\\Main\\Service\\GeoIp\\Manager::getCountryName('92.50.195.50', 'ru');\n// Россия\n\necho \\Bitrix\\Main\\Service\\GeoIp\\Manager::getCountryCode('92.50.195.50');\n// RU\n```\n\nСистема автоматически определяет реальный IP-адрес п", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Получить дополнительные данные", "snippet": "Получить дополнительные данные\nЧтобы получить провайдера, организацию, временную зону или почтовый индекс, используйте следующие методы:\n\n```php\necho \\Bitrix\\Main\\Service\\GeoIp\\Manager::getIspName('92.50.195.50'); // Провайдер\necho \\Bitrix\\", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Получить все данные сразу", "snippet": "Получить все данные сразу\nИспользуйте метод `getDataResult()`, если нужно получить сразу несколько полей и убедиться, что все они доступны.\n\n```php\n$geoResult = \\Bitrix\\Main\\Service\\GeoIp\\Manager::getDataResult(\n '92.50.195.50',\n 'ru'", "page": "docs-advanced-geolocation", "path": "/docs/advanced/geolocation/", "title": "Геолокация"}, {"heading": "Нумератор", "snippet": "Нумератор\nНумератор генерирует уникальные номера по заданному шаблону. В шаблоне используются служебные слова: `{NUMBER}`, `{YEAR}`, `{RANDOM}` и другие.\n\nНумератор обеспечивает уникальность порядковых номеров даже при одновременных запроса", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Базовые генераторы", "snippet": "Базовые генераторы\nДля всех типов нумераторов доступно четыре базовых генератора.\n\n#|\n|| **Генератор** | **Служебные слова** ||\n|| `RandomNumberGenerator` |`{RANDOM}` — случайная строка из заглавных латинских букв и цифр ||\n|| `DateNumberGe", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Дополнительные генераторы", "snippet": "Дополнительные генераторы\n#|\n|| **Тип нумератора** | **Служебные слова** ||\n|| `DOCUMENT` | `{CLIENT_ID}` — идентификатор клиента\n`{SELF_ID}` — идентификатор объекта с данными\n`{SELF_COMPANY_ID}` — идентификатор компании ||\n|| `CRM_QUOTE` |", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Как получить настройки нумератора", "snippet": "Как получить настройки нумератора\nЧтобы получить настройки нумератора, используйте метод `getSettingsFields`.\n\n```php\nuse Bitrix\\Main\\Numerator\\Numerator;\n\n$settings = Numerator::getSettingsFields('DOCUMENT');\n```\n\nМетод возвращает два масс", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Как добавить генератор", "snippet": "Как добавить генератор\nГенератор регистрируют в событии `onNumberGeneratorsClassesCollect`, потому что нумератор формирует динамически список доступных генераторов при инициализации.\n\nНапример, добавьте генератор `TimeNumberGenerator` и слу", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Создать класс генератора", "snippet": "Создать класс генератора\n1. Унаследуйте класс `TimeNumberGenerator` от `NumberGenerator`.\n\n2. В класс добавьте методы:\n\n - `getConfig` — возвращает текущие настройки. Например, формат времени.\n\n - `setConfig` — устанавливает настройк", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Как создать нумератор", "snippet": "Как создать нумератор\nЧтобы создать нумератор, используйте класс `\\Bitrix\\Main\\Numerator\\Numerator`.\n\nПолучить экземпляр\nВызовите метод `create`. Он возвращает пустой объект нумератора без имени и шаблона.\n\n```php\nuse Bitrix\\Main\\Numerator\\", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Передать конфигурацию", "snippet": "Передать конфигурацию\nКонфигурация нумератора — ассоциативный массив. Ключ — тип класса генератора, значение — параметры.\n\n#|\n|| **Генератор** | **Параметры** ||\n|| `Numerator` |`name` — название нумератора, обязательный параметр\n`template`", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Сохранить нумератор", "snippet": "Сохранить нумератор\nМетод `save` возвращает объект результата. При успехе `$result->getId()` содержит идентификатор нового нумератора.\n\n```php\n$result = $numerator->save(); // \\Bitrix\\Main\\Entity\\AddResult\n```\n\nКак получить нумератор\nНумера", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Изменить настройки нумератора", "snippet": "Изменить настройки нумератора\nИзмените конфигурацию и сохраните с помощью метода `update`:\n\n```php\nuse Bitrix\\Main\\Numerator\\Numerator;\n\n$numerator = Numerator::load($numeratorId);\n$config = $numerator->getConfig();\n$config[Numerator::getTy", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Как использовать хеш", "snippet": "Как использовать хеш\nНумератор с `{NUMBER}` может отвечать за несколько последовательных номеров и иметь несколько независимых счетчиков.\n\nЕсли запросить следующий номер у нумератора, получите последовательно увеличивающееся число.\n\n```php\n", "page": "docs-advanced-numerator", "path": "/docs/advanced/numerator/", "title": "Нумератор"}, {"heading": "Пользовательские соглашения", "snippet": "Пользовательские соглашения\nПользовательские соглашения запрашивают согласия на обработку персональных данных, использование cookie, подключение аналитики и другие действия, которые требуют согласия по закону.\n\nСистема не позволяет удалять ", "page": "docs-advanced-user-consent", "path": "/docs/advanced/user-consent/", "title": "Пользовательские соглашения"}, {"heading": "Указать внешнюю ссылку на текст соглашения", "snippet": "Указать внешнюю ссылку на текст соглашения\nДля собственного соглашения можно указать ссылку на текст соглашения, если текст размещен на веб-странице или в файле.\n\n1. В форме соглашения оставьте пустым поле Текст соглашения.\n\n2. Перейдите в ", "page": "docs-advanced-user-consent", "path": "/docs/advanced/user-consent/", "title": "Пользовательские соглашения"}, {"heading": "Подключить соглашение к собственному компоненту", "snippet": "Подключить соглашение к собственному компоненту\nВ системных компонентах вывод соглашений предусмотрен по умолчанию.\n\nВ собственных компонентах соглашения нужно подключить вручную, если запрашиваете персональные данные или используете cookie", "page": "docs-advanced-user-consent", "path": "/docs/advanced/user-consent/", "title": "Пользовательские соглашения"}, {"heading": "Простая форма с событием submit", "snippet": "Простая форма с событием submit\nВ шаблоне собственного компонента подключите `bitrix:main.userconsent.request` перед кнопкой отправки формы.\n\n```php\n
    \n \n Настройки продукта > Соглашения*.\n\n2. Найдите соглашение и нажмите Полученные согласия.\n\n ![](./_images/user-consent.png){width=660px height=247px}\n\n3. Убедитесь, что информация сохране", "page": "docs-advanced-user-consent", "path": "/docs/advanced/user-consent/", "title": "Пользовательские соглашения"}, {"heading": "Права доступа", "snippet": "Права доступа\nПрава доступа — правила, которые определяют, что может делать пользователь на сайте. Это важно для безопасности и разграничения работы с контентом.\n\nОсновные принципы работы прав доступа\n1. **Права на объекты**. Права можно на", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Группы пользователей", "snippet": "Группы пользователей\nКаждый пользователь входит в одну из групп. Если посетитель не авторизован, он автоматически попадает в группу *Неавторизованные пользователи*. У этой группы минимальные права: они могут просматривать данные, разрешенны", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Как ограничить доступ к публичной части сайта", "snippet": "Как ограничить доступ к публичной части сайта\nДоступ к сайту можно временно закрыть для всех пользователей, кроме администраторов.\n\n1. Откройте страницу *Настройки > Настройки продукта > Настройки модулей > Главный модуль.*\n\n2. Включите опц", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Управление уровнями доступа", "snippet": "Управление уровнями доступа\nУправлять уровнями доступа можно в административном разделе на странице *Настройки > Пользователи > Уровни доступа*.\n\n- Пользовательские уровни доступа можно редактировать или создавать новые.\n\n- Системные уров", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Права доступа к инфоблокам", "snippet": "Права доступа к инфоблокам\nПрава доступа для информационных блоков работают аналогично правам статических страниц и разделов. Они наследуются по иерархии: от инфоблока к разделу и элементу. Если пользователь имеет права Полный доступ на инф", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Настроить права для разделов и элементов", "snippet": "Настроить права для разделов и элементов\n1. Включите опцию *Расширенное управление правами* в настройках инфоблока.\n\n ![](./_images/access-control-6.png){width=685px height=568px}\n\n2. Откройте форму редактирования элемента или раздел.\n\n3.", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Файл .access.php", "snippet": "Файл .access.php\nСистема проверяет права доступа из `.access.php` в прологе, то есть перед загрузкой контента и выполнением кода модулей. Пролог работает быстрее проверки прав через интерфейс, так как не требует загрузки ядра. Обычно исполь", "page": "docs-security-access-control", "path": "/docs/security/access-control/", "title": "Права доступа"}, {"heading": "Пример настройки прав через файл", "snippet": "Пример настройки прав через файл\n```php\n`, `\"`, `'`, `&` в HTML-сущности,\n\n- [`\\Bitrix\\Main\\Text\\HtmlFilter::encode`](https://docs.1c-bitr", "page": "docs-security-xss", "path": "/docs/security/xss/", "title": "XSS"}, {"heading": "Атрибуты", "snippet": "Атрибуты\nЗаключайте значения атрибутов в двойные кавычки `\"`. С одинарными кавычками экранирование не сработает.\n\n```php\n\nget($_GET['uri']));\n```\n\nВ примере сервер напрямую обращается ", "page": "docs-security-csrf-ssrf", "path": "/docs/security/csrf-ssrf/", "title": "CSRF и SSRF"}, {"heading": "Ограничение доступа к частным IP", "snippet": "Ограничение доступа к частным IP\nИспользуйте метод `setPrivateIp(false)` в HTTP-клиенте, чтобы запретить запросы к частным адресам.\n\n```php\n$http = new HttpClient(); // Создаем объект HTTP-клиента\n$http->setPrivateIp(false); // Запрещаем до", "page": "docs-security-csrf-ssrf", "path": "/docs/security/csrf-ssrf/", "title": "CSRF и SSRF"}, {"heading": "SQL-инъекции", "snippet": "SQL-инъекции\nSQL-инъекция — уязвимость, которая позволяет внедрить вредоносный код через пользовательский ввод. В Bitrix Framework есть два способа работы с базой данных, каждый требует особого подхода к защите:\n\n- **Прямые запросы.** SQL-", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Класс CDatabase", "snippet": "Класс CDatabase\nЧтобы SQL-запросы были безопасными используйте:\n\n- **Приведение типов для чисел.** Преобразуйте ввод в число, если ожидается числовое значение.\n\n ```php\n // Опасный SQL запрос\n SELECT * FROM b_user WHERE id=$_REQUEST[", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Метод Application::getConnection", "snippet": "Метод Application::getConnection\n```php\n$connection = \\Bitrix\\Main\\Application::getConnection();\n$helper = $connection->getSqlHelper(); // получаем хелпер для экранирования\n\n$login = $helper->forSql($_GET['login']); // очищаем данные\n$res =", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Параметр select", "snippet": "Параметр select\nПараметр `select` указывает, какие поля нужно выбрать из базы данных. Его можно задать двумя способами:\n\n```php\n// В методе getList\n$result = \\Bitrix\\Landing\\Internals\\LandingTable::getList([\n 'select' => $some_select\n]);", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Параметр filter", "snippet": "Параметр filter\nПри наличии `ReferenceField` можно достать данные из связанных таблиц через параметр `filter`.\n\n```php\n// Пример подбора email через фильтр\n$result = \\Bitrix\\Main\\UserTable::getList([\n // Если что-то возвращается, значит ", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Выражения SqlExpression и ExpressionField", "snippet": "Выражения SqlExpression и ExpressionField\nКласс `\\Bitrix\\Main\\DB\\SqlExpression` позволяет создавать пользовательские SQL-выражения. Один непроверенный параметр приведет к инъекции.\n\n```php\n$filterIds = [1, 2, 3, $_GET['id']]; // $_GET['id']", "page": "docs-security-sql-injection", "path": "/docs/security/sql-injection/", "title": "SQL-инъекции"}, {"heading": "Защищенные cookie", "snippet": "Защищенные cookie\n!!! note \"Примечание\"\n\n\n С версии 20.5.400 Главного модуля доступны защищенные cookie `\\Bitrix\\Main\\Web\\CryptoCookie`.\n\n\n\nЗащищенные cookie шифруют данные и делают их недоступными для чтения или изменения без ключа. В о", "page": "docs-security-secure-cookies", "path": "/docs/security/secure-cookies/", "title": "Защищенные cookie"}, {"heading": "Ключ crypto_key", "snippet": "Ключ crypto_key\nДля работы защищенных cookie нужен ключ `crypto_key`. Он используется для шифрования данных. Ключ должен быть уникальным и криптостойким. Рекомендуем создавать ключ длиной 32 символа, состоящий из букв латинского алфавита и ", "page": "docs-security-secure-cookies", "path": "/docs/security/secure-cookies/", "title": "Защищенные cookie"}, {"heading": "Как создать защищенную cookie", "snippet": "Как создать защищенную cookie\nЧтобы создать защищенную cookie, используйте класс `\\Bitrix\\Main\\Web\\CryptoCookie`. Создайте объект `$cookie` и добавьте его в HTTP-ответ, чтобы браузер сохранил cookie.\n\n```php\n$cookie = new \\Bitrix\\Main\\Web\\C", "page": "docs-security-secure-cookies", "path": "/docs/security/secure-cookies/", "title": "Защищенные cookie"}, {"heading": "Почему создаются несколько cookie", "snippet": "Почему создаются несколько cookie\nЗначение cookie ограничено по длине. Зашифрованные данные кодируются в формат base64. Если объем данных превышает допустимый размер cookie, ядро автоматически разбивает их на несколько частей:\n\n- первая co", "page": "docs-security-secure-cookies", "path": "/docs/security/secure-cookies/", "title": "Защищенные cookie"}, {"heading": "Причины ошибки при расшифровке cookie", "snippet": "Причины ошибки при расшифровке cookie\nРасшифровка может завершиться ошибкой, если:\n\n- cookie была изменена или повреждена,\n\n- есть проблемы с синхронизацией времени на серверах,\n\n- используется неверный `crypto_key`.\n\nЧтобы избежать проб", "page": "docs-security-secure-cookies", "path": "/docs/security/secure-cookies/", "title": "Защищенные cookie"}, {"heading": "JWT", "snippet": "JWT\nJWT (JSON Web Token) — это открытый стандарт (RFC 7519) для создания токенов доступа, которые позволяют безопасно передавать данные между сторонами в формате JSON. Токен состоит из трех частей:\n\n- заголовок `header` — указывает алгорит", "page": "docs-security-jwt", "path": "/docs/security/jwt/", "title": "JWT"}, {"heading": "Создать токен", "snippet": "Создать токен\nЧтобы создать JWT-токен, используйте класс `Bitrix\\Main\\Web\\JWT`.\n\n```php\nuse Bitrix\\Main\\Web\\JWT;\n\n$secret = 'ваш-секретный-ключ'; // Храните его в безопасности\n$payload = [\n 'user_id' => 123, // ID пользователя\n ", "page": "docs-security-jwt", "path": "/docs/security/jwt/", "title": "JWT"}, {"heading": "Ограничить время действия токена", "snippet": "Ограничить время действия токена\nЧтобы ограничить время действия токена, добавьте в `payload` параметры:\n\n- `iat` — время создания,\n\n- `exp` — срок действия,\n\n- `nbf` — время начала работы.\n\n```php\nuse Bitrix\\Main\\Web\\JWT;\n\n$secret = 'се", "page": "docs-security-jwt", "path": "/docs/security/jwt/", "title": "JWT"}, {"heading": "Проверить токен", "snippet": "Проверить токен\nЧтобы проверить токен и получить данные используйте метод `decode`.\n\n```php\nuse Bitrix\\Main\\Web\\JWT;\n\n$secret = 'ваш-секретный-ключ';\n$jwt = 'токен-полученный-от-клиента';\n\ntry\n{\n $payload = JWT::decode($jwt, $secret, ['H", "page": "docs-security-jwt", "path": "/docs/security/jwt/", "title": "JWT"}, {"heading": "Поддерживаемые алгоритмы подписи", "snippet": "Поддерживаемые алгоритмы подписи\nКласс `Bitrix\\Main\\Web\\JWT` поддерживает алгоритмы:\n\n| **Алгоритм** | **Тип подписи** | **Использует** |\n|--------------|-----------------|-------------------|\n| HS256 | HMAC + SHA-256 | Симметрич", "page": "docs-security-jwt", "path": "/docs/security/jwt/", "title": "JWT"}, {"heading": "Санитайзер", "snippet": "Санитайзер\nСанитайзер в Bitrix Framework защищает сайт от XSS-атак:\n\n- удаляет или экранирует опасные теги и атрибуты,\n\n- автоматически закрывает незакрытые теги,\n\n- корректирует структуру HTML,\n\n- экранирует специальные символы.", "page": "docs-security-sanitizer", "path": "/docs/security/sanitizer/", "title": "Санитайзер"}, {"heading": "Методы класса CBXSanitizer", "snippet": "Методы класса CBXSanitizer\nДля работы с санитайзером используются методы класса [CBXSanitizer](https://dev.1c-bitrix.ru/api_help/main/reference/cbxsanitizer/index.php).\n\n- `AddTags(array $tags)` — добавляет теги и атрибуты в список разреше", "page": "docs-security-sanitizer", "path": "/docs/security/sanitizer/", "title": "Санитайзер"}, {"heading": "Как использовать санитайзер", "snippet": "Как использовать санитайзер\n1. Создайте объект санитайзера.\n\n ```php\n $Sanitizer = new CBXSanitizer();\n ```\n\n2. Задайте правила фильтрации. Например, разрешите определенные теги и атрибуты с помощью функции [AddTags](https://dev.1c-bi", "page": "docs-security-sanitizer", "path": "/docs/security/sanitizer/", "title": "Санитайзер"}, {"heading": "Уровни фильтрации", "snippet": "Уровни фильтрации\nУровни фильтрации — это предустановленные наборы, содержащие разрешенные теги и атрибуты. Санитайзер поддерживает четыре уровня фильтрации:\n\n1. Высокий уровень `SECURE_LEVEL_HIGH`\n\n Разрешает только базовые текстовые тег", "page": "docs-security-sanitizer", "path": "/docs/security/sanitizer/", "title": "Санитайзер"}, {"heading": "Как применить уровень фильтрации", "snippet": "Как применить уровень фильтрации\nЧтобы применить один из уровней, используйте метод `setLevel`:\n\n```php\n// Создаем объект санитайзера\n$Sanitizer = new CBXSanitizer;\n\n// Устанавливаем средний уровень фильтрации\n$Sanitizer->SetLevel(CBXSaniti", "page": "docs-security-sanitizer", "path": "/docs/security/sanitizer/", "title": "Санитайзер"}, {"heading": "Firewall", "snippet": "Firewall\nВ Bitrix Framework есть встроенный инструмент для защиты веб-приложений от вредоносного кода — Проактивный фильтр (Web Application Firewall). Он анализирует HTTP-запросы и блокирует распространенные атаки: SQL-инъекции, XSS и друго", "page": "docs-security-firewall", "path": "/docs/security/firewall/", "title": "Firewall"}, {"heading": "Как настроить Проактивный фильтр", "snippet": "Как настроить Проактивный фильтр\nОткройте форму Активная реакция, чтобы настроить действия системы при попытке вторжения на сайт.\n\n1. В поле *Активная реакция на вторжение* задайте реакцию системы на вторжение.\n\n - **Сделать данные безоп", "page": "docs-security-firewall", "path": "/docs/security/firewall/", "title": "Firewall"}, {"heading": "Как настроить исключения для Проактивного фильтра", "snippet": "Как настроить исключения для Проактивного фильтра\nВы можете задать исключения из Проактивного фильтра для страниц и для пользователей.\n\n!!! warning \"Внимание\"\n\n\n Для защиты на стандартном уровне включите Проактивный фильтр и не задавайте", "page": "docs-security-firewall", "path": "/docs/security/firewall/", "title": "Firewall"}, {"heading": "Исключения для пользователей", "snippet": "Исключения для пользователей\n1. Откройте страницу *Настройки > Настройки продукта > Настройки модулей > Проактивная защита*.\n\n2. Перейдите на вкладку Доступ.\n\n3. Для нужных групп пользователей выберите уровень доступа `[F] Обход проактивног", "page": "docs-security-firewall", "path": "/docs/security/firewall/", "title": "Firewall"}, {"heading": "Как вручную добавить правило блокировки", "snippet": "Как вручную добавить правило блокировки\nПравило блокировки запрещает доступ указанным IP-адресам или диапазонам IP-адресов к конкретным разделам сайта.\n\n1. Перейдите на страницу *Настройки > Проактивная защита > Стоп-лист*.\n\n2. Нажмите Доба", "page": "docs-security-firewall", "path": "/docs/security/firewall/", "title": "Firewall"}, {"heading": "Защита от фреймов", "snippet": "Защита от фреймов\nФреймы `` и `