worldwide open-source software - software:development:demo:cms:ucms

appendix_a

anonymous@undisclosed.example.com (Anonymous) — Thu, 08 May 2025 13:33:25 +0000

Public Domain Mark 1.0 Universal

PDM 1.0 КРАТКОЕ ОПИСАНИЕ

Canonical URL https://creativecommons.org/publicdomain/mark/1.0/

Нет авторских прав

Это произведение было идентифицировано как являющееся свободным от известных ограничений по закону об авторских правах, включая все связанные и смежные права. Вы можете копировать, изменять, распространять и исполнять данное произведение, даже в коммерческих целях, всё не спрашивая разрешения.

См. «Другую информацию» ниже.

Другая информация

Это произведение может иметь некоторые правовые ограничения в каких либо юрисдикциях. Лица могут иметь другие права, связанные с данным произведением, такие как патентные права или права торговой марки, а другие могут иметь права в том как данное произведение используется, такие как права публичности или конфиденциальности.
В некоторых юрисдикциях моральные права данного автора могут сохраняться вне зависимости от срока действия авторского права. Эти права могут включать право быть указанным в качестве автора или право возражать против пренебрежительного обращения.
Если прямо не указано иное, лицо, идентифицирующее данное произведение не даёт никаких гарантий относительно произведения и не несет ответственности за все виды использования произведения, в максимально возможной степени, допустимой применимым правом.
При использовании или цитировании произведения вы не должны намекать на то, что вас поддерживает автор или лицо, идентифицирующее произведение.

appendix_c

anonymous@undisclosed.example.com (Anonymous) — Sat, 03 May 2025 09:37:04 +0000

Выбор часового пояса

timezones.php

<?php
/**
 * List of timezones
 */
return array(
    'Pacific/Midway' => '(UTC-11:00) Midway',
    'Pacific/Niue' => '(UTC-11:00) Niue',
    'Pacific/Pago_Pago' => '(UTC-11:00) Pago Pago',
    'America/Adak' => '(UTC-10:00) Adak',
    'Pacific/Honolulu' => '(UTC-10:00) Honolulu',
    'Pacific/Johnston' => '(UTC-10:00) Johnston',
    'Pacific/Rarotonga' => '(UTC-10:00) Rarotonga',
    'Pacific/Tahiti' => '(UTC-10:00) Tahiti',
    'Pacific/Marquesas' => '(UTC-09:30) Marquesas',
    'America/Anchorage' => '(UTC-09:00) Anchorage',
    'Pacific/Gambier' => '(UTC-09:00) Gambier',
    'America/Juneau' => '(UTC-09:00) Juneau',
    'America/Nome' => '(UTC-09:00) Nome',
    'America/Sitka' => '(UTC-09:00) Sitka',
    'America/Yakutat' => '(UTC-09:00) Yakutat',
    'America/Dawson' => '(UTC-08:00) Dawson',
    'America/Los_Angeles' => '(UTC-08:00) Los Angeles',
    'America/Metlakatla' => '(UTC-08:00) Metlakatla',
    'Pacific/Pitcairn' => '(UTC-08:00) Pitcairn',
    'America/Santa_Isabel' => '(UTC-08:00) Santa Isabel',
    'America/Tijuana' => '(UTC-08:00) Tijuana',
    'America/Vancouver' => '(UTC-08:00) Vancouver',
    'America/Whitehorse' => '(UTC-08:00) Whitehorse',
    'America/Boise' => '(UTC-07:00) Boise',
    'America/Cambridge_Bay' => '(UTC-07:00) Cambridge Bay',
    'America/Chihuahua' => '(UTC-07:00) Chihuahua',
    'America/Creston' => '(UTC-07:00) Creston',
    'America/Dawson_Creek' => '(UTC-07:00) Dawson Creek',
    'America/Denver' => '(UTC-07:00) Denver',
    'America/Edmonton' => '(UTC-07:00) Edmonton',
    'America/Hermosillo' => '(UTC-07:00) Hermosillo',
    'America/Inuvik' => '(UTC-07:00) Inuvik',
    'America/Mazatlan' => '(UTC-07:00) Mazatlan',
    'America/Ojinaga' => '(UTC-07:00) Ojinaga',
    'America/Phoenix' => '(UTC-07:00) Phoenix',
    'America/Shiprock' => '(UTC-07:00) Shiprock',
    'America/Yellowknife' => '(UTC-07:00) Yellowknife',
    'America/Bahia_Banderas' => '(UTC-06:00) Bahia Banderas',
    'America/Belize' => '(UTC-06:00) Belize',
    'America/North_Dakota/Beulah' => '(UTC-06:00) Beulah',
    'America/Cancun' => '(UTC-06:00) Cancun',
    'America/North_Dakota/Center' => '(UTC-06:00) Center',
    'America/Chicago' => '(UTC-06:00) Chicago',
    'America/Costa_Rica' => '(UTC-06:00) Costa Rica',
    'Pacific/Easter' => '(UTC-06:00) Easter',
    'America/El_Salvador' => '(UTC-06:00) El Salvador',
    'Pacific/Galapagos' => '(UTC-06:00) Galapagos',
    'America/Guatemala' => '(UTC-06:00) Guatemala',
    'America/Indiana/Knox' => '(UTC-06:00) Knox',
    'America/Managua' => '(UTC-06:00) Managua',
    'America/Matamoros' => '(UTC-06:00) Matamoros',
    'America/Menominee' => '(UTC-06:00) Menominee',
    'America/Merida' => '(UTC-06:00) Merida',
    'America/Mexico_City' => '(UTC-06:00) Mexico City',
    'America/Monterrey' => '(UTC-06:00) Monterrey',
    'America/North_Dakota/New_Salem' => '(UTC-06:00) New Salem',
    'America/Rainy_River' => '(UTC-06:00) Rainy River',
    'America/Rankin_Inlet' => '(UTC-06:00) Rankin Inlet',
    'America/Regina' => '(UTC-06:00) Regina',
    'America/Resolute' => '(UTC-06:00) Resolute',
    'America/Swift_Current' => '(UTC-06:00) Swift Current',
    'America/Tegucigalpa' => '(UTC-06:00) Tegucigalpa',
    'America/Indiana/Tell_City' => '(UTC-06:00) Tell City',
    'America/Winnipeg' => '(UTC-06:00) Winnipeg',
    'America/Atikokan' => '(UTC-05:00) Atikokan',
    'America/Bogota' => '(UTC-05:00) Bogota',
    'America/Cayman' => '(UTC-05:00) Cayman',
    'America/Detroit' => '(UTC-05:00) Detroit',
    'America/Grand_Turk' => '(UTC-05:00) Grand Turk',
    'America/Guayaquil' => '(UTC-05:00) Guayaquil',
    'America/Havana' => '(UTC-05:00) Havana',
    'America/Indiana/Indianapolis' => '(UTC-05:00) Indianapolis',
    'America/Iqaluit' => '(UTC-05:00) Iqaluit',
    'America/Jamaica' => '(UTC-05:00) Jamaica',
    'America/Lima' => '(UTC-05:00) Lima',
    'America/Kentucky/Louisville' => '(UTC-05:00) Louisville',
    'America/Indiana/Marengo' => '(UTC-05:00) Marengo',
    'America/Kentucky/Monticello' => '(UTC-05:00) Monticello',
    'America/Montreal' => '(UTC-05:00) Montreal',
    'America/Nassau' => '(UTC-05:00) Nassau',
    'America/New_York' => '(UTC-05:00) New York',
    'America/Nipigon' => '(UTC-05:00) Nipigon',
    'America/Panama' => '(UTC-05:00) Panama',
    'America/Pangnirtung' => '(UTC-05:00) Pangnirtung',
    'America/Indiana/Petersburg' => '(UTC-05:00) Petersburg',
    'America/Port-au-Prince' => '(UTC-05:00) Port-au-Prince',
    'America/Thunder_Bay' => '(UTC-05:00) Thunder Bay',
    'America/Toronto' => '(UTC-05:00) Toronto',
    'America/Indiana/Vevay' => '(UTC-05:00) Vevay',
    'America/Indiana/Vincennes' => '(UTC-05:00) Vincennes',
    'America/Indiana/Winamac' => '(UTC-05:00) Winamac',
    'America/Caracas' => '(UTC-04:30) Caracas',
    'America/Anguilla' => '(UTC-04:00) Anguilla',
    'America/Antigua' => '(UTC-04:00) Antigua',
    'America/Aruba' => '(UTC-04:00) Aruba',
    'America/Asuncion' => '(UTC-04:00) Asuncion',
    'America/Barbados' => '(UTC-04:00) Barbados',
    'Atlantic/Bermuda' => '(UTC-04:00) Bermuda',
    'America/Blanc-Sablon' => '(UTC-04:00) Blanc-Sablon',
    'America/Boa_Vista' => '(UTC-04:00) Boa Vista',
    'America/Campo_Grande' => '(UTC-04:00) Campo Grande',
    'America/Cuiaba' => '(UTC-04:00) Cuiaba',
    'America/Curacao' => '(UTC-04:00) Curacao',
    'America/Dominica' => '(UTC-04:00) Dominica',
    'America/Eirunepe' => '(UTC-04:00) Eirunepe',
    'America/Glace_Bay' => '(UTC-04:00) Glace Bay',
    'America/Goose_Bay' => '(UTC-04:00) Goose Bay',
    'America/Grenada' => '(UTC-04:00) Grenada',
    'America/Guadeloupe' => '(UTC-04:00) Guadeloupe',
    'America/Guyana' => '(UTC-04:00) Guyana',
    'America/Halifax' => '(UTC-04:00) Halifax',
    'America/Kralendijk' => '(UTC-04:00) Kralendijk',
    'America/La_Paz' => '(UTC-04:00) La Paz',
    'America/Lower_Princes' => '(UTC-04:00) Lower Princes',
    'America/Manaus' => '(UTC-04:00) Manaus',
    'America/Marigot' => '(UTC-04:00) Marigot',
    'America/Martinique' => '(UTC-04:00) Martinique',
    'America/Moncton' => '(UTC-04:00) Moncton',
    'America/Montserrat' => '(UTC-04:00) Montserrat',
    'Antarctica/Palmer' => '(UTC-04:00) Palmer',
    'America/Port_of_Spain' => '(UTC-04:00) Port of Spain',
    'America/Porto_Velho' => '(UTC-04:00) Porto Velho',
    'America/Puerto_Rico' => '(UTC-04:00) Puerto Rico',
    'America/Rio_Branco' => '(UTC-04:00) Rio Branco',
    'America/Santiago' => '(UTC-04:00) Santiago',
    'America/Santo_Domingo' => '(UTC-04:00) Santo Domingo',
    'America/St_Barthelemy' => '(UTC-04:00) St. Barthelemy',
    'America/St_Kitts' => '(UTC-04:00) St. Kitts',
    'America/St_Lucia' => '(UTC-04:00) St. Lucia',
    'America/St_Thomas' => '(UTC-04:00) St. Thomas',
    'America/St_Vincent' => '(UTC-04:00) St. Vincent',
    'America/Thule' => '(UTC-04:00) Thule',
    'America/Tortola' => '(UTC-04:00) Tortola',
    'America/St_Johns' => '(UTC-03:30) St. Johns',
    'America/Araguaina' => '(UTC-03:00) Araguaina',
    'America/Bahia' => '(UTC-03:00) Bahia',
    'America/Belem' => '(UTC-03:00) Belem',
    'America/Argentina/Buenos_Aires' => '(UTC-03:00) Buenos Aires',
    'America/Argentina/Catamarca' => '(UTC-03:00) Catamarca',
    'America/Cayenne' => '(UTC-03:00) Cayenne',
    'America/Argentina/Cordoba' => '(UTC-03:00) Cordoba',
    'America/Fortaleza' => '(UTC-03:00) Fortaleza',
    'America/Godthab' => '(UTC-03:00) Godthab',
    'America/Argentina/Jujuy' => '(UTC-03:00) Jujuy',
    'America/Argentina/La_Rioja' => '(UTC-03:00) La Rioja',
    'America/Maceio' => '(UTC-03:00) Maceio',
    'America/Argentina/Mendoza' => '(UTC-03:00) Mendoza',
    'America/Miquelon' => '(UTC-03:00) Miquelon',
    'America/Montevideo' => '(UTC-03:00) Montevideo',
    'America/Paramaribo' => '(UTC-03:00) Paramaribo',
    'America/Recife' => '(UTC-03:00) Recife',
    'America/Argentina/Rio_Gallegos' => '(UTC-03:00) Rio Gallegos',
    'Antarctica/Rothera' => '(UTC-03:00) Rothera',
    'America/Argentina/Salta' => '(UTC-03:00) Salta',
    'America/Argentina/San_Juan' => '(UTC-03:00) San Juan',
    'America/Argentina/San_Luis' => '(UTC-03:00) San Luis',
    'America/Santarem' => '(UTC-03:00) Santarem',
    'America/Sao_Paulo' => '(UTC-03:00) Sao Paulo',
    'Atlantic/Stanley' => '(UTC-03:00) Stanley',
    'America/Argentina/Tucuman' => '(UTC-03:00) Tucuman',
    'America/Argentina/Ushuaia' => '(UTC-03:00) Ushuaia',
    'America/Noronha' => '(UTC-02:00) Noronha',
    'Atlantic/South_Georgia' => '(UTC-02:00) South Georgia',
    'Atlantic/Azores' => '(UTC-01:00) Azores',
    'Atlantic/Cape_Verde' => '(UTC-01:00) Cape Verde',
    'America/Scoresbysund' => '(UTC-01:00) Scoresbysund',
    'Africa/Abidjan' => '(UTC+00:00) Abidjan',
    'Africa/Accra' => '(UTC+00:00) Accra',
    'Africa/Bamako' => '(UTC+00:00) Bamako',
    'Africa/Banjul' => '(UTC+00:00) Banjul',
    'Africa/Bissau' => '(UTC+00:00) Bissau',
    'Atlantic/Canary' => '(UTC+00:00) Canary',
    'Africa/Casablanca' => '(UTC+00:00) Casablanca',
    'Africa/Conakry' => '(UTC+00:00) Conakry',
    'Africa/Dakar' => '(UTC+00:00) Dakar',
    'America/Danmarkshavn' => '(UTC+00:00) Danmarkshavn',
    'Europe/Dublin' => '(UTC+00:00) Dublin',
    'Africa/El_Aaiun' => '(UTC+00:00) El Aaiun',
    'Atlantic/Faroe' => '(UTC+00:00) Faroe',
    'Africa/Freetown' => '(UTC+00:00) Freetown',
    'Europe/Guernsey' => '(UTC+00:00) Guernsey',
    'Europe/Isle_of_Man' => '(UTC+00:00) Isle of Man',
    'Europe/Jersey' => '(UTC+00:00) Jersey',
    'Europe/Lisbon' => '(UTC+00:00) Lisbon',
    'Africa/Lome' => '(UTC+00:00) Lome',
    'Europe/London' => '(UTC+00:00) London',
    'Atlantic/Madeira' => '(UTC+00:00) Madeira',
    'Africa/Monrovia' => '(UTC+00:00) Monrovia',
    'Africa/Nouakchott' => '(UTC+00:00) Nouakchott',
    'Africa/Ouagadougou' => '(UTC+00:00) Ouagadougou',
    'Atlantic/Reykjavik' => '(UTC+00:00) Reykjavik',
    'Africa/Sao_Tome' => '(UTC+00:00) Sao Tome',
    'Atlantic/St_Helena' => '(UTC+00:00) St. Helena',
    'UTC' => '(UTC+00:00) UTC',
    'Africa/Algiers' => '(UTC+01:00) Algiers',
    'Europe/Amsterdam' => '(UTC+01:00) Amsterdam',
    'Europe/Andorra' => '(UTC+01:00) Andorra',
    'Africa/Bangui' => '(UTC+01:00) Bangui',
    'Europe/Belgrade' => '(UTC+01:00) Belgrade',
    'Europe/Berlin' => '(UTC+01:00) Berlin',
    'Europe/Bratislava' => '(UTC+01:00) Bratislava',
    'Africa/Brazzaville' => '(UTC+01:00) Brazzaville',
    'Europe/Brussels' => '(UTC+01:00) Brussels',
    'Europe/Budapest' => '(UTC+01:00) Budapest',
    'Europe/Busingen' => '(UTC+01:00) Busingen',
    'Africa/Ceuta' => '(UTC+01:00) Ceuta',
    'Europe/Copenhagen' => '(UTC+01:00) Copenhagen',
    'Africa/Douala' => '(UTC+01:00) Douala',
    'Europe/Gibraltar' => '(UTC+01:00) Gibraltar',
    'Africa/Kinshasa' => '(UTC+01:00) Kinshasa',
    'Africa/Lagos' => '(UTC+01:00) Lagos',
    'Africa/Libreville' => '(UTC+01:00) Libreville',
    'Europe/Ljubljana' => '(UTC+01:00) Ljubljana',
    'Arctic/Longyearbyen' => '(UTC+01:00) Longyearbyen',
    'Africa/Luanda' => '(UTC+01:00) Luanda',
    'Europe/Luxembourg' => '(UTC+01:00) Luxembourg',
    'Europe/Madrid' => '(UTC+01:00) Madrid',
    'Africa/Malabo' => '(UTC+01:00) Malabo',
    'Europe/Malta' => '(UTC+01:00) Malta',
    'Europe/Monaco' => '(UTC+01:00) Monaco',
    'Africa/Ndjamena' => '(UTC+01:00) Ndjamena',
    'Africa/Niamey' => '(UTC+01:00) Niamey',
    'Europe/Oslo' => '(UTC+01:00) Oslo',
    'Europe/Paris' => '(UTC+01:00) Paris',
    'Europe/Podgorica' => '(UTC+01:00) Podgorica',
    'Africa/Porto-Novo' => '(UTC+01:00) Porto-Novo',
    'Europe/Prague' => '(UTC+01:00) Prague',
    'Europe/Rome' => '(UTC+01:00) Rome',
    'Europe/San_Marino' => '(UTC+01:00) San Marino',
    'Europe/Sarajevo' => '(UTC+01:00) Sarajevo',
    'Europe/Skopje' => '(UTC+01:00) Skopje',
    'Europe/Stockholm' => '(UTC+01:00) Stockholm',
    'Europe/Tirane' => '(UTC+01:00) Tirane',
    'Africa/Tripoli' => '(UTC+01:00) Tripoli',
    'Africa/Tunis' => '(UTC+01:00) Tunis',
    'Europe/Vaduz' => '(UTC+01:00) Vaduz',
    'Europe/Vatican' => '(UTC+01:00) Vatican',
    'Europe/Vienna' => '(UTC+01:00) Vienna',
    'Europe/Warsaw' => '(UTC+01:00) Warsaw',
    'Africa/Windhoek' => '(UTC+01:00) Windhoek',
    'Europe/Zagreb' => '(UTC+01:00) Zagreb',
    'Europe/Zurich' => '(UTC+01:00) Zurich',
    'Europe/Athens' => '(UTC+02:00) Athens',
    'Asia/Beirut' => '(UTC+02:00) Beirut',
    'Africa/Blantyre' => '(UTC+02:00) Blantyre',
    'Europe/Bucharest' => '(UTC+02:00) Bucharest',
    'Africa/Bujumbura' => '(UTC+02:00) Bujumbura',
    'Africa/Cairo' => '(UTC+02:00) Cairo',
    'Europe/Chisinau' => '(UTC+02:00) Chisinau',
    'Asia/Damascus' => '(UTC+02:00) Damascus',
    'Africa/Gaborone' => '(UTC+02:00) Gaborone',
    'Asia/Gaza' => '(UTC+02:00) Gaza',
    'Africa/Harare' => '(UTC+02:00) Harare',
    'Asia/Hebron' => '(UTC+02:00) Hebron',
    'Europe/Helsinki' => '(UTC+02:00) Helsinki',
    'Europe/Istanbul' => '(UTC+02:00) Istanbul',
    'Asia/Jerusalem' => '(UTC+02:00) Jerusalem',
    'Africa/Johannesburg' => '(UTC+02:00) Johannesburg',
    'Europe/Kiev' => '(UTC+02:00) Kiev',
    'Africa/Kigali' => '(UTC+02:00) Kigali',
    'Africa/Lubumbashi' => '(UTC+02:00) Lubumbashi',
    'Africa/Lusaka' => '(UTC+02:00) Lusaka',
    'Africa/Maputo' => '(UTC+02:00) Maputo',
    'Europe/Mariehamn' => '(UTC+02:00) Mariehamn',
    'Africa/Maseru' => '(UTC+02:00) Maseru',
    'Africa/Mbabane' => '(UTC+02:00) Mbabane',
    'Asia/Nicosia' => '(UTC+02:00) Nicosia',
    'Europe/Riga' => '(UTC+02:00) Riga',
    'Europe/Simferopol' => '(UTC+02:00) Simferopol',
    'Europe/Sofia' => '(UTC+02:00) Sofia',
    'Europe/Tallinn' => '(UTC+02:00) Tallinn',
    'Europe/Uzhgorod' => '(UTC+02:00) Uzhgorod',
    'Europe/Vilnius' => '(UTC+02:00) Vilnius',
    'Europe/Zaporozhye' => '(UTC+02:00) Zaporozhye',
    'Africa/Addis_Ababa' => '(UTC+03:00) Addis Ababa',
    'Asia/Aden' => '(UTC+03:00) Aden',
    'Asia/Amman' => '(UTC+03:00) Amman',
    'Indian/Antananarivo' => '(UTC+03:00) Antananarivo',
    'Africa/Asmara' => '(UTC+03:00) Asmara',
    'Asia/Baghdad' => '(UTC+03:00) Baghdad',
    'Asia/Bahrain' => '(UTC+03:00) Bahrain',
    'Indian/Comoro' => '(UTC+03:00) Comoro',
    'Africa/Dar_es_Salaam' => '(UTC+03:00) Dar es Salaam',
    'Africa/Djibouti' => '(UTC+03:00) Djibouti',
    'Africa/Juba' => '(UTC+03:00) Juba',
    'Europe/Kaliningrad' => '(UTC+03:00) Kaliningrad',
    'Africa/Kampala' => '(UTC+03:00) Kampala',
    'Africa/Khartoum' => '(UTC+03:00) Khartoum',
    'Asia/Kuwait' => '(UTC+03:00) Kuwait',
    'Indian/Mayotte' => '(UTC+03:00) Mayotte',
    'Europe/Minsk' => '(UTC+03:00) Minsk',
    'Africa/Mogadishu' => '(UTC+03:00) Mogadishu',
    'Europe/Moscow' => '(UTC+03:00) Moscow',
    'Africa/Nairobi' => '(UTC+03:00) Nairobi',
    'Asia/Qatar' => '(UTC+03:00) Qatar',
    'Asia/Riyadh' => '(UTC+03:00) Riyadh',
    'Antarctica/Syowa' => '(UTC+03:00) Syowa',
    'Asia/Tehran' => '(UTC+03:30) Tehran',
    'Asia/Baku' => '(UTC+04:00) Baku',
    'Asia/Dubai' => '(UTC+04:00) Dubai',
    'Indian/Mahe' => '(UTC+04:00) Mahe',
    'Indian/Mauritius' => '(UTC+04:00) Mauritius',
    'Asia/Muscat' => '(UTC+04:00) Muscat',
    'Indian/Reunion' => '(UTC+04:00) Reunion',
    'Europe/Samara' => '(UTC+04:00) Samara',
    'Asia/Tbilisi' => '(UTC+04:00) Tbilisi',
    'Europe/Volgograd' => '(UTC+04:00) Volgograd',
    'Asia/Yerevan' => '(UTC+04:00) Yerevan',
    'Asia/Kabul' => '(UTC+04:30) Kabul',
    'Asia/Aqtau' => '(UTC+05:00) Aqtau',
    'Asia/Aqtobe' => '(UTC+05:00) Aqtobe',
    'Asia/Ashgabat' => '(UTC+05:00) Ashgabat',
    'Asia/Dushanbe' => '(UTC+05:00) Dushanbe',
    'Asia/Karachi' => '(UTC+05:00) Karachi',
    'Indian/Kerguelen' => '(UTC+05:00) Kerguelen',
    'Indian/Maldives' => '(UTC+05:00) Maldives',
    'Antarctica/Mawson' => '(UTC+05:00) Mawson',
    'Asia/Oral' => '(UTC+05:00) Oral',
    'Asia/Samarkand' => '(UTC+05:00) Samarkand',
    'Asia/Tashkent' => '(UTC+05:00) Tashkent',
    'Asia/Colombo' => '(UTC+05:30) Colombo',
    'Asia/Kolkata' => '(UTC+05:30) Kolkata',
    'Asia/Kathmandu' => '(UTC+05:45) Kathmandu',
    'Asia/Almaty' => '(UTC+06:00) Almaty',
    'Asia/Bishkek' => '(UTC+06:00) Bishkek',
    'Indian/Chagos' => '(UTC+06:00) Chagos',
    'Asia/Dhaka' => '(UTC+06:00) Dhaka',
    'Asia/Qyzylorda' => '(UTC+06:00) Qyzylorda',
    'Asia/Thimphu' => '(UTC+06:00) Thimphu',
    'Antarctica/Vostok' => '(UTC+06:00) Vostok',
    'Asia/Yekaterinburg' => '(UTC+06:00) Yekaterinburg',
    'Indian/Cocos' => '(UTC+06:30) Cocos',
    'Asia/Rangoon' => '(UTC+06:30) Rangoon',
    'Asia/Bangkok' => '(UTC+07:00) Bangkok',
    'Indian/Christmas' => '(UTC+07:00) Christmas',
    'Antarctica/Davis' => '(UTC+07:00) Davis',
    'Asia/Ho_Chi_Minh' => '(UTC+07:00) Ho Chi Minh',
    'Asia/Hovd' => '(UTC+07:00) Hovd',
    'Asia/Jakarta' => '(UTC+07:00) Jakarta',
    'Asia/Novokuznetsk' => '(UTC+07:00) Novokuznetsk',
    'Asia/Novosibirsk' => '(UTC+07:00) Novosibirsk',
    'Asia/Omsk' => '(UTC+07:00) Omsk',
    'Asia/Phnom_Penh' => '(UTC+07:00) Phnom Penh',
    'Asia/Pontianak' => '(UTC+07:00) Pontianak',
    'Asia/Vientiane' => '(UTC+07:00) Vientiane',
    'Asia/Brunei' => '(UTC+08:00) Brunei',
    'Antarctica/Casey' => '(UTC+08:00) Casey',
    'Asia/Choibalsan' => '(UTC+08:00) Choibalsan',
    'Asia/Chongqing' => '(UTC+08:00) Chongqing',
    'Asia/Harbin' => '(UTC+08:00) Harbin',
    'Asia/Hong_Kong' => '(UTC+08:00) Hong Kong',
    'Asia/Kashgar' => '(UTC+08:00) Kashgar',
    'Asia/Krasnoyarsk' => '(UTC+08:00) Krasnoyarsk',
    'Asia/Kuala_Lumpur' => '(UTC+08:00) Kuala Lumpur',
    'Asia/Kuching' => '(UTC+08:00) Kuching',
    'Asia/Macau' => '(UTC+08:00) Macau',
    'Asia/Makassar' => '(UTC+08:00) Makassar',
    'Asia/Manila' => '(UTC+08:00) Manila',
    'Australia/Perth' => '(UTC+08:00) Perth',
    'Asia/Shanghai' => '(UTC+08:00) Shanghai',
    'Asia/Singapore' => '(UTC+08:00) Singapore',
    'Asia/Taipei' => '(UTC+08:00) Taipei',
    'Asia/Ulaanbaatar' => '(UTC+08:00) Ulaanbaatar',
    'Asia/Urumqi' => '(UTC+08:00) Urumqi',
    'Australia/Eucla' => '(UTC+08:45) Eucla',
    'Asia/Dili' => '(UTC+09:00) Dili',
    'Asia/Irkutsk' => '(UTC+09:00) Irkutsk',
    'Asia/Jayapura' => '(UTC+09:00) Jayapura',
    'Pacific/Palau' => '(UTC+09:00) Palau',
    'Asia/Pyongyang' => '(UTC+09:00) Pyongyang',
    'Asia/Seoul' => '(UTC+09:00) Seoul',
    'Asia/Tokyo' => '(UTC+09:00) Tokyo',
    'Australia/Adelaide' => '(UTC+09:30) Adelaide',
    'Australia/Broken_Hill' => '(UTC+09:30) Broken Hill',
    'Australia/Darwin' => '(UTC+09:30) Darwin',
    'Australia/Brisbane' => '(UTC+10:00) Brisbane',
    'Pacific/Chuuk' => '(UTC+10:00) Chuuk',
    'Australia/Currie' => '(UTC+10:00) Currie',
    'Antarctica/DumontDUrville' => '(UTC+10:00) DumontDUrville',
    'Pacific/Guam' => '(UTC+10:00) Guam',
    'Australia/Hobart' => '(UTC+10:00) Hobart',
    'Asia/Khandyga' => '(UTC+10:00) Khandyga',
    'Australia/Lindeman' => '(UTC+10:00) Lindeman',
    'Australia/Melbourne' => '(UTC+10:00) Melbourne',
    'Pacific/Port_Moresby' => '(UTC+10:00) Port Moresby',
    'Pacific/Saipan' => '(UTC+10:00) Saipan',
    'Australia/Sydney' => '(UTC+10:00) Sydney',
    'Asia/Yakutsk' => '(UTC+10:00) Yakutsk',
    'Australia/Lord_Howe' => '(UTC+10:30) Lord Howe',
    'Pacific/Efate' => '(UTC+11:00) Efate',
    'Pacific/Guadalcanal' => '(UTC+11:00) Guadalcanal',
    'Pacific/Kosrae' => '(UTC+11:00) Kosrae',
    'Antarctica/Macquarie' => '(UTC+11:00) Macquarie',
    'Pacific/Noumea' => '(UTC+11:00) Noumea',
    'Pacific/Pohnpei' => '(UTC+11:00) Pohnpei',
    'Asia/Sakhalin' => '(UTC+11:00) Sakhalin',
    'Asia/Ust-Nera' => '(UTC+11:00) Ust-Nera',
    'Asia/Vladivostok' => '(UTC+11:00) Vladivostok',
    'Pacific/Norfolk' => '(UTC+11:30) Norfolk',
    'Asia/Anadyr' => '(UTC+12:00) Anadyr',
    'Pacific/Auckland' => '(UTC+12:00) Auckland',
    'Pacific/Fiji' => '(UTC+12:00) Fiji',
    'Pacific/Funafuti' => '(UTC+12:00) Funafuti',
    'Asia/Kamchatka' => '(UTC+12:00) Kamchatka',
    'Pacific/Kwajalein' => '(UTC+12:00) Kwajalein',
    'Asia/Magadan' => '(UTC+12:00) Magadan',
    'Pacific/Majuro' => '(UTC+12:00) Majuro',
    'Antarctica/McMurdo' => '(UTC+12:00) McMurdo',
    'Pacific/Nauru' => '(UTC+12:00) Nauru',
    'Antarctica/South_Pole' => '(UTC+12:00) South Pole',
    'Pacific/Tarawa' => '(UTC+12:00) Tarawa',
    'Pacific/Wake' => '(UTC+12:00) Wake',
    'Pacific/Wallis' => '(UTC+12:00) Wallis',
    'Pacific/Chatham' => '(UTC+12:45) Chatham',
    'Pacific/Apia' => '(UTC+13:00) Apia',
    'Pacific/Enderbury' => '(UTC+13:00) Enderbury',
    'Pacific/Fakaofo' => '(UTC+13:00) Fakaofo',
    'Pacific/Tongatapu' => '(UTC+13:00) Tongatapu',
    'Pacific/Kiritimati' => '(UTC+14:00) Kiritimati',
);

application_installer

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 17:15:56 +0000

8. Установщик приложения

Существует множество вариантов установки приложений. Вариант установки через запуск скрипта на сервере и автоматической загрузкой всех директорий и файлов, с автозапуском, будет рассмотрен в Приложении В к данному руководству.

В этой же Главе мы рассмотрим вариант, когда пользователь скачивает .zip архив приложения, разорхивирует его и загрузит файлы на свой веб - сервер. Далее пользователь в веб - браузере переходит в папку приложения, и начинается процесс установки.

Процесс установки будет состоять из проверки веб - сервера пользователя. Будут проверены:

Версия PHP,
Версия Apache http server,
Наличие установленной версии системы управления базами данных MySQL,
Модули и библиотеки PHP
Права на чтение/запись в папки и файлы
Отсутствие файла конфигурации

Если что-то не будет соответствовать нашим требованиям, то процесс установки приостановиться с указанием ошибки и просьбой исправить ошибку и перезагрузить окно установщика.

Если требования соответсятвуют, то приложение активирует кнопку перехода к выбору

Язык приложения (для приложения му будем использовать русский и английский языки)
Название приложения (имя которое будет отображаться на логотипе приложения)

после указания язык приложения и названия приложения активируется кнопка перехода к настройкам подключения к системе управления базами данных MySQL, где пользователю предстоит заполнить обязательные поля, с проверкой заполнения

Адрес системы управления базами данных
Имя пользователя системы управления базами данных
Пароль пользователя системы управления базами данных

после проверки заполнения полей, приложение проверит возможность подключения к системе управления базами данных MySQL, и выведит сообщение об успешном/ошибочном подключении к системы управления БД. В случае успеха активируется кнопка для перехода к окну создания базы данных и таблиц базы данных, а так же данными администратора приложения, с обязательными полями для заполнения

Имя базы данных
Префикс таблицы базы данных (для установки нескольких копий приложения)
Имя администратора
Почта администратора (с проверкой на валидность)
Логин администратора
Пароль администратора (с проверкой на сложность)
Повторный пароль администратора

В случае правильности введенных данных, приложение создаст базу данных, создаст таблицу базы данных, захэширует пароль и введенные данные администратора запишет в нашу базу данных. На экране пользователя будет наблюдаться прогресс-бар, после которого приложение перенаправит пользователя на страницу авторизации пользователя и удалит папку установщика.

← 7.4. Файл .htaccess 8.1. Создание директорий установщика →

checking_web_server

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Apr 2025 18:49:33 +0000

8.1. Создание директорий установщика

Директорию установщика install неоходима для проверки сервера и установки приложения. Если бы мы преследовали цель создать одно готовое приложения, например видеохостинг, то после установки, будет правильнее прописать код удаления этой директории за ненадобностью в дальнейшем. А так как мы хотим создать универсальную CMS, то у нас установщик даст возможность выбора вида приложения (видеохостин, блог или социальная сеть), и в последствии пользователь будет иметь возможность доустановить необходимую часть приложения.

Следуя нашему проекту структуры директорий будущего приложения, создадим директории и файлы для нашего установщика: В корневой директории ucms нашего приложения создадим:

Директорию includes
Директорию library
Директорию test
Файл help.txt
Файл index.php
Файл readme.txt
Файл version.php

В директории library нашего приложения создадим:

Вложенную директорию install

В директории install нашего приложения создадим:

Вложенную директорию css в директории install
Файл install.css в директории css
Вложенную директорию js в директории install
Файл install.js в директории js
Файл account_settings.php в директории install
Файл database_options.php в директории install
Файл install.php в директории install
Файл installation_progress.php в директории install
Файл options.php в директории install
Файл server_check.php в директории install
Файл setting.php в директории install

В этой Главе мы научимся создавать директории и файлы с последующим заполнением файлов данными средствами PHP, а пока нас вполне устроит создание файлов вручную, а созданное нами приложение в конечном виде, уже будет иметь все необходимые файлы и директории при распаковке скачанного архива.

← 8. Установщик приложения 8.2. Файл cons.php →

creating_file_config

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 17:35:17 +0000

7.2. Файл config.ini

Введение

config.ini - это файл конфигурации нашего приложения (ядра), мы с вами ничего записывать в него самостоятельно не будем и в конце этой главы мы его удалим. Этот файл будет создаваться при установке нашего приложением и в него будут записаны файлы конфигурации.

В данном случае мы создаем пустой файл config.ini для проверки работы логики установщика. А именно:
Установщик проверит, есть ли в директории /ucms/includes файл config.ini, что будет означать, что установка уже произведена и повторная не требуется и перенаправит пользователя на страницу установленой конфигурации, в случае отсутствия файла config.ini продолжится установка.

Добавим в нашу дерикторию тестов, тестовый файл config_test.php и в него запишем следующий код:

config_test.php

<!--  config_test.php  -->
 
<?php
	/* Подключем файл cons.php из директории includes  */
    include "../includes/cons.php";
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.php' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
	/* Если config.config.ini существует */
        if (file_exists($file_config)) {
	/* выводим запись о существовании */
			echo "Файл $file_config существует";
	/* Иначе выводим запись о существовании*/
		} else {
			echo "Файл $file_config не существует";
		}
?>

Сохраним изменения и проверим работу кода в браузере

Заходим в директорию includes и перемещаем файл config.ini в директорию demo

Проверим снова работу кода файла config_test.php в браузере

Получаем сообщение: Файл /volume1/web/ucms/includes/config.php не существует

В директории includes и в директории /test создаем файл config_test_2.php

config_test_2.php

<!--  config_test_2.php  -->
<?php 
// Создание и вызов параметров из .ini файла
////////////////////////////////////////////
/* задаем переменной  значение $config 
* parse_ini_file - обрабатывает конфигурационный файл
* ../../includes/config.ini - путь к config.ini
* ,true); - обрабатываем с секциями (зпголовками)
*/
$config = parse_ini_file("../includes/config.ini",true);
// Проверьте, успешно ли прочитан ini-файл.
// переменная $config не ровно ЛОЖЬ
if ($config !== false) {
    // Доступ к индивидуальным настройкам
 
	$server = $config['database']['server'];
      echo "server: " . $server . "\n";
	$port = $config['database']['port'];
      echo "port: " . $port . "\n";
} else {
    echo "Ошибка чтения INI-файла.";	
}
 
// Создаем массив пар
$databaseSections = [
    'server' => 'localhost',
    'port' => 3000,
];
 
// Записать конфигурацию в раздел «'database'»
$success = write_to_ini($databaseSections, 'database', '../includes/config.ini');
 
// Проверим, успешно ли выполнена запись в файл.
if ($success) {
    echo "Запись в файл прошла успешно!";
} else {
    echo "Ошибка записи INI-файла.";
}
// Функция записи настроек в определенный раздел INI-файла
function write_to_ini($config, $section, $file) {
    $content = "\n; Application Configuration Settings\n\n[$section]\n; Configuration\n";
 
    foreach ($config as $key => $value) {
        $content .= "$key = $value\n";
    }
 
    // Добавить содержимое в файл
    return file_put_contents($file, $content, FILE_APPEND) !== false;
}

Запись данных в config.ini

Откроем файл config_test_2.php в браузере

Мы видим сообщение «Ошибка чтения INI-файла.» и «Запись в файл прошла успешно!»

Чтение данных из config.ini

Обновим страницу веб-браузера

файл config.ini в директории /includes создан и выводится значения переменных $server и $port в сообщении: server: localhost port: 3000

Откроем созданный файл config.ini в блокноте

Мы видем записи нашего массива в файле. Перемещаем config.ini в директорию demo

← 7.1. Файл cons.php 7.3. Файл function.php →

creating_file_cons

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 17:34:42 +0000

7.1. Файл cons.php

Введение

cons.php - это служебный файл, который будет хранить наши постоянные значения данных - константы. Функция define — определяет именованную константу.
Пример №1. Определение констант

cons_test.php

<?php
define("CONSTANT", "Это константа - CONSTANT.");
define("Constant", " А вот это - Constant, а не CONSTANT и это совсем другая константа");
echo CONSTANT."<br/>"; // выводит "Это - CONSTANT.", 
// ."<br/>" просто переносит следующий вывод на другую строку для удобства
echo Constant."<br/>"; // выводит "А вот это - Constant, а не CONSTANT".
?>

<?php - определяем начало границы выполнения кода PHP
define — Определяет именованную константу
<br/> - просто переносит вывод на новую строку
?> - определяем конец границы выполнения кода PHP

Создадим в главной директории /ucms вложенную директори test и в ней создадим файл cons_test.php. Запишем данный код:

и откроем его в веб - браузере

Как вы уже догадались, файл cons_test.php создан нами для пробы кода в работе, и в конце проекта мы его удалим. А пока заходим в наш файл - помошник help.txt и зписаваем на память следующее

help.txt

-----------------------------------------------------------------------
echo CONSTANT."<br/>"; // выводит значение CONSTANT с переносом на другую строку
-----------------------------------------------------------------------

А так же в файл readme.txt производим запись, что файл «cons_test.php - файл для тестовой проверки кода проекта»

cons.php

Создадим в главной директории /ucms поддерикторию /includes нашего приложения создадим:

Вложенную директорию demo
Файл config.php в директории includes
Файл cons.php в директории includes

Запишем в файл cons.php следующий код:

cons.php

<?php
// получим директорию веб-сервера
define("ROOT", dirname(__DIR__));
// выводим на экран главную директорию
echo ROOT."<br/>";
// зададим главную директорию
define("FOLDER", ROOT . '');
// выводим на экран главную директорию /ucms
echo FOLDER . "<br/>";
// определим вложенную директорию установщика
define("INSTALL", ROOT . '/library/install');
// выводим на экран главную директорию /ucms/library/install
echo INSTALL;
/*define Это константа. ROOT Это путь с самой первой папки на сервере.*/
 
/*Здесь в FOLDER хранится полный путь к нашей папке "ucms", 
что в нашем случае будет корневой директорией приложения, а не сервера.
Дальше можем подключать наши файлы просто так: $file_config = FOLDER . '/includes/config.php';*/
?>

и откроем данный файл cons.php для проверки вывода в браузере

Как мы можем видеть константам

FOLDER присвоено значение /volume1/web/ucms
INSTALL присвоено значение /volume1/web/ucms/library/install

Внимание! /volume1/web/ - это путь корневой папки Apache сервера synology nas, на сервере ubuntu с установленным Apache путь будет выглядеть /var/www/html/ucms

Пример вывода WAMP-сервера:

Удаляем из файла cons.php строки содержащие конструкцию для вывода объектов (echo)

echo ROOT.«<br/>»;
echo FOLDER . «<br/>»;
echo INSTALL;

После удаления, мы в итоге должны получить файл cons.php с содержимым следующего вида:

cons.php

<?php
// получим директорию веб-сервера
define("ROOT", dirname(__DIR__));
// зададим путь главной директории
define("FOLDER", ROOT . '');
// определим путь вложенной директории установщика
define("INSTALL", ROOT . '/library/install');
 
/*define Это константа. ROOT Это путь с самой первой папки на сервере.*/
 
/*Здесь в FOLDER хранится полный путь к нашей папке "ucms", 
что в нашем случае будет корневой директорией приложения, а не сервера.
Дальше можем подключать наши файлы просто так: $file_config = FOLDER . '/includes/config.php';*/
?>

← 7.0. Файл version.php 7.2. Файл config.php →

creating_file_function

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 16:42:18 +0000

7.3. Файл function.php

Введение

Этот файл будет представлять из себя основную библиотеку созданных нами пользовательских функций. Так как нам неизвестно, какую конфигурацию установит пользователь, то имеет смысл в модулях и конфигурациях создать свои файлы пользовательских функций (например: function_blog.php).

Функция — это блок операторов, который можно многократно использовать в программе.
Функция не будет выполняться автоматически при загрузке страницы.
Функция будет выполнена путем вызова функции.

Файл function_test.php

/test/function_test.php - означает директория /test файл function_test.php - если его нет, то создаем и записываем код:

function_test.php

<?php
/* Файл function_test.php */
function testFunction() {
  echo "это простая фунция";
}
testFunction();

Проверяем в браузере

Файл function.php

Создадим в директории /ucms/includes пустой файл функций function.php

function.php

/* Файл function.php */

← 7.2. Файл config.ini 7.4. Файл .htaccess →

creating_file_install_css

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Dec 2025 14:12:11 +0000

8.8. Файл install.css

Это файл стилей установщика. В нашем приложении будет несколько конфигураци и модулей. Модуль приложения install имеет цель установить приложение, доустановить модули и имеет отдельный вид шаблона и модулей, поэтому папка стилей для установщика и файл install.css находяться в директории /library/install

В главе 8.4. Файл lang_and_time_zone.php мы заранее создали контейнер для Кнопки с классом install_button

<div class = "install_button">
</div>

Создадим стили для размещения кнопки справа

style.css

.install_button {
	display: flex; /*наш блок стал flex-контейнер*/
    justify-content: flex-end; /*прижимается к правому краю*/
}

А так-же заранее создали контейнер для Погресс-бара с классом progressbar

<div class="progressbar">
  <span style="width: 20%"></span>
</div>

В главе 8.5. Файл server_check.php мы

style.css

← 8.7. Файл install.php 8.9. Файл template.php →

creating_file_lang_and_time_zone

anonymous@undisclosed.example.com (Anonymous) — Fri, 09 May 2025 10:21:17 +0000

8.4. Файл lang_and_time_zone.php

Этот файл выполняет функцию начального экрана установщика и предоставляет пользователю выбор язык приложения и временную зону, а также создает файл конфигурации config.php в директории /includes/ и записывает в него переменные $lang_select и $timezone_select, полученные из форм выбора.

$lang_select - выбор языка приложения (русский и англиский, при необходимости можно добавлять переводы)
$timezone_select - время сервера приложения (время написания поста, время отправки сообщений и т.д.)

Формы

<form action="install.php" method="post">
</form>

form action=«install.php» - указывает обработчик, к которому обращаются данные формы при их отправке на сервер.

В нашем случае это переход к файлу install.php (подробнее файл install.php будет описан в Главе 8.6).

Внимание:
Файл lang_and_time_zone.php будет подключен внутри и будет отображать данные в теле файла install.php, поэтому form action=«install.php» будет просто обновлять страницу при отправки данных на сервер.

method=«post» - в отличие от метода GET, который используется для получения данных, POST служит для отправки данных на сервер.

В файле lang_and_time_zone.php у нас будет два вида формы для наглядности

input type=«radio» - переключатель
select type=«text» - выпадающий список

Переключатель

Используется для примера, при добавлении большего количества переводов приложения, целесообразнее, использовать «выпадающий список».

<input type="radio" method="post" name="lang_selection" value="english" checked />
<label for="lang_english"> English</label>
<br>

input type=«radio» - переключатель
method=«post» - в отличие от метода GET, который используется для получения данных, POST служит для отправки данных на сервер.
id=«lang_english» - идентификатор формы
name=«lang_selection» - имя формы
value=«english» - принимаемое значение
checked - определяет выбор формы переключателя (т.е. выбран по умолчанию)
label for=«lang_english» - надпись для элимента
br - перенос на следующую строку

Выпадающий список

Используется для выбора часового пояса работы сервера, т.е. при физически установленном сервере в Дании и использовании Приложения для русскоязычного населения, бедет отображаться время комминтариев «Московское».

<select type="text" name="timezone_selection">
    <option value="Europe/Moscow">Europe/Moscow +03:00</option>
    <option value="Europe/Amsterdam">Europe/Amsterdam +01:00</option>
    <option value="Europe/Dublin">Europe/Dublin +00:00</option>
    <option value="Europe/Samara">Europe/Samara +04:00</option> 
</select>

select type=«text» - выпадающий список
name=«timezone_selection» - имя формы
option value= - определитель значение пункта списка, которое будет отправлено на сервер.

Идентификатор формы, надпись для элимента и перенос на следующую строку не указываем т.к. в примере выше мы это сделали для «Чистоты кода» и на логику работы кода это не влияет (т.е. для наглядности примера, а именно: select type=«text» - определяет выпадающий список, name=«timezone_selection» - имя формы из которого данные получит переменная и option value= - значение пункта формы).

Значение пункта данной формы - это всего лишь время добавляемое к времени часового пояса места установки сервера (т.е. -2, -1, 0, +1 и т.д.) и мы могли бы это записать, но для наглядности пропишем именно обозначения «таймзон». Полный список зон можно выбрать из формы ниже:

Данная форма выбора будет рассмотрена в Приложении C этого руководства, пока же нас интересует 26 часовых поясов для выбора (от -11 до +14).

    <option value="Pacific/Kiritimati">Pacific/Kiritimati +14:00</option>
    <option value="Pacific/Tongatapu">Pacific/Tongatapu +13:00</option>
    <option value="Pacific/Majuro">Pacific/Majuro +12:00</option>
    <option value="Pacific/Pohnpei">Pacific/Pohnpei +11:00</option>
    <option value="Australia/Melbourne">Australia/Melbourne +10:00</option> 
    <option value="Asia/Tokyo">Asia/Tokyo +09:00</option> 
    <option value="Asia/Hong_Kong">Asia/Hong_Kong +08:00</option>
    <option value="Asia/Bangkok">Asia/Bangkok +07:00</option> 
    <option value="Asia/Bishkek">Asia/Bishkek +06:00</option> 
    <option value="Indian/Maldives">Indian/Maldives +05:00</option>
    <option value="Asia/Dubai">Asia/Dubai +04:00</option> 
    <option value="Europe/Moscow">Europe/Moscow +03:00</option>
    <option value="Europe/Helsinki">Europe/Helsinki +02:00</option> 
    <option value="Europe/Bratislava">Europe/Bratislava +01:00</option>
    <option value="Europe/Dublin">Europe/Dublin +00:00</option>
    <option value="Atlantic/Azores">Atlantic/Azores -01:00</option>
    <option value="Atlantic/South_Georgia">Atlantic/South_Georgia -02:00</option>
    <option value="America/Sao_Paulo">America/Sao_Paulo -03:00</option>
    <option value="America/Montserrat">America/Montserrat -04:00</option>
    <option value="America/Jamaica">America/Jamaica -05:00</option>
    <option value="America/Regina">America/Regina -06:00</option>
    <option value="America/Denver">America/Denver -07:00</option>
    <option value="America/Vancouver">America/Vancouver -08:00</option>
    <option value="America/Sitka">America/Sitka -09:00</option>
    <option value="Pacific/Tahiti">Pacific/Tahiti -10:00</option>
    <option value="Pacific/Midway">Pacific/Midway -10:00</option>

Пимечание:
Данный код приложения, это всего лишь установщик выводимого времени и нам нет смысла создавать отдельный файл timezones.php с массивом со всеми 418 часовыми зонами, т.к. установщик - это не основное приложение, а визуально понятный сборщик данных для корректной работы нашего приложения. Файл timezones.php с массивом будет описан в Приложении C этого руководства.

Кнопка

 
	<div class = "button_lang_and_time_zone">
	<input type="submit" value="Продолжить" name="button_lang_and_time_zone">
	</div>

input - интерактивный элемент управления
type= - тип элемента для отображения
«submit» - кнопка для отправки формы
value= - значение элемента управления, в нашем случае это название кнопки «Продолжить»
name=«lang_and_time_zone» - имя формы, которое отправляется вместе с данными формы

Пимечание:
Код приведенный ниже, это всего лишь обертка нашей формы, к классу button_lang_and_time_zone позже будут подключенны стили ранее созданного (пока пустого) файла install.css в директории css.

 
	<div class = "button_lang_and_time_zone">
	</div>

Кнопку «Назад» логично расположить по левому краю формы, а кнопку «Вперед» или «Продолжить» по правому. Это мы позже и пропишем в файле install.css.

div class = «button_lang_and_time_zone» - создан нами заранее, что-бы в Главе 8.6. Файл install.css при указании стиля кнопки соблюсти последовательность написания данного руководства и нам в дальнейшем не прийдется вазвращатся в Файл lang_and_time_zone.php для «обертывания» нашей кнопки.

Логика формы

У нас имеется переключатель языков с выбранным по умолчанию Английским языком и поле выбора часовой зоны, с Pacific/Kiritimati +14:00 по умолчанию (первая в списке выбора) и кнопка «Продолжить».
При нажатии кнопки будет проверенно условие, что выбор произведен, либо оставлен по умолчанию (это нам понадобиться позже для того, чтобы по умолчанию программа вывела нам язык и часовую зону сервера). Следом будет создан файл конфигурации приложения config.php и в него запишется наш выбор в виде объявленных переменных $lang_select и $timezone_select. После этого приложение направит нас к файлу проверки сервера server_check.php

<?php
$lang_select = $_POST['lang_selection'];
$timezone_select = $_POST['timezone_selection'];

<?php - определяем начало границы выполнения кода PHP
$lang_select = $_POST['lang_selection']; - объявляем переменную $lang_select и присваиваем ей значение с помощью глобального ассоциативного массива $_POST данные из нашей формы «Переключателя» по имени name=«lang_selection»
$timezone_select = $_POST['timezone_selection']; - объявляем переменную $timezone_selection и присваиваем ей значение с помощью глобального ассоциативного массива $_POST данные из нашей формы «Выпадающего списка» по имени name=«timezone_selection»

Проверим что переменные lang_selection и timezone_selection определены

if(isset($_POST['lang_selection']) && isset($_POST['timezone_selection']))
{тут мы проверим, нажатие кнопки и запишем логику создания файла config.txt}

if(...) - логический оператор условия ЕСЛИ
isset(...) - функция определения инициализации переменной
$_POST['lang_selection'] - глобальный ассоциативный массив $_POST с данными из нашей формы «Переключателя» по имени name=«lang_selection»
&& - логический оператор И
$_POST['timezone_selection'] - глобальный ассоциативный массив $_POST с данными из нашей формы «Выпадающего списка» по имени name=«timezone_selection»

Проверим что кнопка button_lang_and_time_zone нажата (необходимо чтобы наш код выполнялся только по нажатию, и не выполнялся при открытии, либо перезагрузке страницы).

if(isset($_POST['button_lang_and_time_zone'])) {$bam="ИСТИНА";
echo "Кнопка нажата и переменной bam присвоенно значение = " . "$bam";
file_put_contents("config.txt","Hello World. Testing!");
echo "Файл config.txt создан и данные записаны!";
} else {$bam="ЛОЖЬ"; 
echo "Кнопка не нажата и переменной bam присвоенно значение = "  . "$bam";
}

if(...){...} - логический оператор условия ЕСЛИ
isset(...) - функция определения инициализации переменной
$_POST['button_lang_and_time_zone'] - глобальный ассоциативный массив $_POST с данными из нашей формы «Кнопка» по имени name=«button_lang_and_time_zone»
$bam="ИСТИНА" - переменной $bam присвоили значение =«ИСТИНА»
echo "...." - вывели текст нажатия кнопки и значение «ИСТИНА» присвоенное переменной $bam
else(...){...} - логическая конструкция ИНАЧЕ оператора условия ЕСЛИ
$bam="ЛОЖЬ" - переменной $bam присвоили значение =«ЛОЖЬ»
echo "...." - вывели текст нажатия кнопки и значение «ЛОЖЬ» присвоенное переменной $bam
file_put_contents - функция записи данных в файл запишет Hello World. Testing! в файл config.txt

Описанный выше код проверит условие:
ЕСЛИ кнопка нажата, присвоится переменной значение ИСТИНА и выведиться текст «Кнопка нажата» и значение переменной, а так же в этой-же директории будет создан файл config.txt и в него будет записано сообщение: Hello World. Testing!, ИНАЧЕ присвоится той же переменной значение ЛОЖЬ и выведиться текст «Кнопка не нажата» и значение переменной

Файл test_3

Создадим в директории /ucms/test/ файл test_3.php, объединим выше разобранный нами код и запишем во вновь созданный файл следующее:

test_3.php

<!--  test_3.php  -->
 
<form action="test_3.php" method="post">
Выберите язык приложения: <br/>
  <input type="radio" method="post" id="lang_english" name="lang_selection" value="english" checked /> 
  <label for="lang_english">English</label>
  <br>
  <input type="radio" method="post" name="lang_selection" value="russian"> Russian</p>
 
Выберите часовой пояс: <br/>
<select type="text" name="timezone_selection">
    <option value="Pacific/Kiritimati">Pacific/Kiritimati +14:00</option>
    <option value="Pacific/Tongatapu">Pacific/Tongatapu +13:00</option>
    <option value="Pacific/Majuro">Pacific/Majuro +12:00</option>
    <option value="Pacific/Pohnpei">Pacific/Pohnpei +11:00</option>
    <option value="Australia/Melbourne">Australia/Melbourne +10:00</option> 
    <option value="Asia/Tokyo">Asia/Tokyo +09:00</option> 
    <option value="Asia/Hong_Kong">Asia/Hong_Kong +08:00</option>
    <option value="Asia/Bangkok">Asia/Bangkok +07:00</option> 
    <option value="Asia/Bishkek">Asia/Bishkek +06:00</option> 
    <option value="Indian/Maldives">Indian/Maldives +05:00</option>
    <option value="Asia/Dubai">Asia/Dubai +04:00</option> 
    <option value="Europe/Moscow">Europe/Moscow +03:00</option>
    <option value="Europe/Helsinki">Europe/Helsinki +02:00</option> 
    <option value="Europe/Bratislava">Europe/Bratislava +01:00</option>
    <option value="Europe/Dublin">Europe/Dublin +00:00</option>
    <option value="Atlantic/Azores">Atlantic/Azores -01:00</option>
    <option value="Atlantic/South_Georgia">Atlantic/South_Georgia -02:00</option>
    <option value="America/Sao_Paulo">America/Sao_Paulo -03:00</option>
    <option value="America/Montserrat">America/Montserrat -04:00</option>
    <option value="America/Jamaica">America/Jamaica -05:00</option>
    <option value="America/Regina">America/Regina -06:00</option>
    <option value="America/Denver">America/Denver -07:00</option>
    <option value="America/Vancouver">America/Vancouver -08:00</option>
    <option value="America/Sitka">America/Sitka -09:00</option>
    <option value="Pacific/Tahiti">Pacific/Tahiti -10:00</option>
    <option value="Pacific/Midway">Pacific/Midway -10:00</option>
</select>
	<div class = "install_button">
	<input type="submit" value="Продолжить" name="button_lang_and_time_zone">
	</div>
</form>
<?php
$lang_select = $_POST['lang_selection'];
$timezone_select = $_POST['timezone_selection'];
// Проверим что lang_selection и timezone_selection определены
if(isset($_POST['lang_selection']) && isset($_POST['timezone_selection']))
{
if(isset($_POST['button_lang_and_time_zone'])) {$bam="ИСТИНА";
echo "Кнопка нажата и переменной bam присвоенно значение = " . "$bam" . '<br/>';
echo "$lang_select" . '<br/>';
echo "$timezone_select" . '<br/>';
file_put_contents("config.txt","Hello World. Testing!");
echo "Файл config.txt создан и данные записаны!";
}
}
else {$bam="ЛОЖЬ"; 
echo "Кнопка не нажата и переменной bam присвоенно значение = "  . "$bam" . '<br/>';
echo "$lang_select" . '<br/>';
echo "$timezone_select" . '<br/>';
}
?>

И откроем файл test_3.php в браузере для проверки работы логики приложения

Как видно в окне приложения, кнопка «Продолжить» еще не нажата, поэтому выводится сообщение: Кнопка не нажата и переменной bam присвоенно значение = ЛОЖЬ. При этом значения переменных $lang_select" и $timezone_select не выводятся, по причине не активности кнопки формы.

Не трогаем окна выбора, а просто обновим окно браузера, ничего не измениться, т.к. работает проверка нажатия кнопки. Активируем кнопку «Продолжить»: Получаем сообщение: Кнопка нажата и переменной bam присвоенно значение = ИСТИНА, а так-же значения переменных $lang_select" = english и $timezone_select = Pacific/Kiritimati указанные по умолчанию, т.е. когда переключатели мы не трогали и самое главное: в директории /ucms/test/ появился файл config.txt, а чем нас уведомило сообщение: Файл config.txt создан и данные записаны!

Проверим наш созданный файл config.txt и убеждаемся, что текст Hello World. Testing! записан.

Выбирем другой язык, а так же другой часовой пояс и нажмем кнопку Продолжить

Мы видим, что переменные $lang_select" и $timezone_select приняли другие значения. На этом проверку логики закончим.

8.4. Файл lang_and_time_zone.php

Откроем в блокноте созданный ранее в директории /ucms/library/install/ файл lang_and_time_zone.php и запишем в него код из файла test_3.php, убрав лишнее, а именно:

вывод на экран сообщений о нажатии кнопки и присвоении переменным $lang_select" и $timezone_select

значений, а так-же вывод на экран сообщения Файл config.txt создан и данные записаны! Так-же откорректируем код в части form action=«test_3.php»

заменим form action=«test_3.php» на form action=«install.php»
заменим file_put_contents(«config.txt»,«Hello World. Testing!»);« на приведенный ниже код:

$file_lang_and_time_zone = '../../includes/config.php';
file_put_contents($file_lang_and_time_zone, '<?php ' . "\n", FILE_APPEND);
file_put_contents($file_lang_and_time_zone, '$lang_select' . ' = ' . '"' . $lang_select . '"' . '; ' . "\n", FILE_APPEND);
file_put_contents($file_lang_and_time_zone, '$timezone_select' . ' = ' . '"' . $timezone_select . '"' . '; ' . "\n", FILE_APPEND);
file_put_contents($file_lang_and_time_zone, '?> ' . "\n", FILE_APPEND);
header("Location: server_check.php");

$file_lang_and_time_zone = '../../includes/config.php'; - присвоим переменной $file_lang_and_time_zone" значение, указывающее путь к директории /includes/, где будет создан файл config.php
../../includes/config.php - значение вновь создаваемого файла config.php в директории /includes/.
file_put_contents - функция PHP записи в файл config.php месторасположение которого присвоенно переменной $file_lang_and_time_zone"
<?php - записывается определение начала границы выполнения кода PHP
\n - записывается символ перевода строки кода PHP
, FILE_APPEND - флаг записи данных в конец файла, вместо перезаписи
$lang_select - записывается переменная $lang_select
= - записывается логический знак =(равно)
$lang_select - записывается значение! переменной $lang_select присвоенное ранее из формы

То-же самое прописанно и для переменной $timezone_select

?> - записывается определение конца границы выполнения кода PHP
header("Location: - перенаправление к коду файла проверки сервера server_check.php

В результате в файле config.php получим следующую запись:

<?php 
$lang_select = "english"; 
$timezone_select = "Pacific/Kiritimati"; 
?>

где переменной $lang_select присвоенно значение языка по умолчанию, т.е english, а переменной $timezone_select - присвоенно значение часовой зоны Pacific/Kiritimati

в конец нашего файла добавим следующий код «Прогресс-бара», чтобы пользователь знач, где он в данный момент находиться.

<?php 
<div class="progressbar">
  <span style="width: 20%"></span>
</div>

Пимечание:
Код приведенный выше, это всего лишь обертка блока «Погресс-бара», который будет написан на чистом css и пока соответственно мы его не видим. Позже будут подключенны стили ранее созданного (пока пустого) файла install.css в директории css и «Погресс-бар» отобразиться.

В заключении мы добавим проверку того, что если это не первая установка, т.е. файл config.php существует в директории /includes, то окно выбора языка и часовой зоны будет пропущенно и приложение переадресует нас к выбору устанавливаемой конфигурации приложения (блог, видеохостинг и.д.), за что будет отвечать файл options.php.

Код проверки приведен ниже:

include "../../includes/cons.php";
$file_config = FOLDER . '/includes/config.php';
if (file_exists($file_config)) {
	/* Вызов header, перенаправит пользователя на страницу
	/options.php в этой же директории */
    header("Location: options.php");
} else { 
Сюда будет записан весь наш код формы
}

include "../../includes/cons.php"; - включает и оценивает код файла cons.php из диретории /includes/ как PHP-код
$file_config = FOLDER . '/includes/config.php'; - переменной $file_config присвоили значение /includes/config.php (местонахождения файла config.php)
if(...){...} - логический оператор условия ЕСЛИ
file_exists(...) - функция проверки существования указанного файла или каталога.
header("Location: options.php") - функция перенаправления пользователя к файлу options.php.
else{...} - логическая конструкция ИНАЧЕ оператора условия ЕСЛИ

Ниже приведен отредактированный и имеющий заключительный вид код файла lang_and_time_zone.php

lang_and_time_zone.php

<?php
include "../../includes/cons.php";
$file_config = FOLDER . '/includes/config.php';
if (file_exists($file_config)) {
	/* Вызов header, перенаправит пользователя на страницу
	/options.php в этой же директории */
    header("Location: options.php");
} else { 
$lang_select = $_POST['lang_selection'];
$timezone_select = $_POST['timezone_selection'];
// Проверим что lang_selection и timezone_selection определены
if(isset($_POST['lang_selection']) && isset($_POST['timezone_selection']))
{
if(isset($_POST['button_lang_and_time_zone'])) {
//добавляем текст и значения переменных $lang_select и timezone_select
//в конец создаваемого файла config.php
$filename = '../../includes/config.php';
file_put_contents($filename, '<?php ' . "\n", FILE_APPEND);
file_put_contents($filename, '$lang_select' . ' = ' . '"' . $lang_select . '"' . '; ' . "\n", FILE_APPEND);
file_put_contents($filename, '$timezone_select' . ' = ' . '"' . $timezone_select . '"' . '; ' . "\n", FILE_APPEND);
file_put_contents($filename, '?> ' . "\n", FILE_APPEND);
header("Location: server_check.php");
}
}
}
?>
<form action="install.php" method="post">
Выберите язык приложения: <br/>
  <input type="radio" method="post" id="lang_english" name="lang_selection" value="english" checked /> 
  <label for="lang_english">English</label>
  <br>
  <input type="radio" method="post" name="lang_selection" value="russian"> Russian</p>
 
Выберите часовой пояс: <br/>
<select type="text" name="timezone_selection">
    <option value="Pacific/Kiritimati">Pacific/Kiritimati +14:00</option>
    <option value="Pacific/Tongatapu">Pacific/Tongatapu +13:00</option>
    <option value="Pacific/Majuro">Pacific/Majuro +12:00</option>
    <option value="Pacific/Pohnpei">Pacific/Pohnpei +11:00</option>
    <option value="Australia/Melbourne">Australia/Melbourne +10:00</option> 
    <option value="Asia/Tokyo">Asia/Tokyo +09:00</option> 
    <option value="Asia/Hong_Kong">Asia/Hong_Kong +08:00</option>
    <option value="Asia/Bangkok">Asia/Bangkok +07:00</option> 
    <option value="Asia/Bishkek">Asia/Bishkek +06:00</option> 
    <option value="Indian/Maldives">Indian/Maldives +05:00</option>
    <option value="Asia/Dubai">Asia/Dubai +04:00</option> 
    <option value="Europe/Moscow">Europe/Moscow +03:00</option>
    <option value="Europe/Helsinki">Europe/Helsinki +02:00</option> 
    <option value="Europe/Bratislava">Europe/Bratislava +01:00</option>
    <option value="Europe/Dublin">Europe/Dublin +00:00</option>
    <option value="Atlantic/Azores">Atlantic/Azores -01:00</option>
    <option value="Atlantic/South_Georgia">Atlantic/South_Georgia -02:00</option>
    <option value="America/Sao_Paulo">America/Sao_Paulo -03:00</option>
    <option value="America/Montserrat">America/Montserrat -04:00</option>
    <option value="America/Jamaica">America/Jamaica -05:00</option>
    <option value="America/Regina">America/Regina -06:00</option>
    <option value="America/Denver">America/Denver -07:00</option>
    <option value="America/Vancouver">America/Vancouver -08:00</option>
    <option value="America/Sitka">America/Sitka -09:00</option>
    <option value="Pacific/Tahiti">Pacific/Tahiti -10:00</option>
    <option value="Pacific/Midway">Pacific/Midway -10:00</option>
</select>
	<div class = "install_button">
	<input type="submit" value="Продолжить" name="button_lang_and_time_zone">
	</div>
</form>
 
<div class="progressbar">
  <span style="width: 20%"></span>
</div>

Запишем его в тело файла lang_and_time_zone.php и откроем его в окне браузера для проверки, где после отправки формы у нас созается файл config.php с данными и браузер нас перенаправляет на страницу проверки сервера server_check.php о которой речь пойдет в следующей главе 8.5. Файл server_check.php, а пока мы получим пустое окно.

Если мы повторно в адресной строке браузера набирем путь к нашему файлу lang_and_time_zone.php, то нас приложение перенаправит на страницу выбора конфигурации установки options.php

← 8.3. Файл lang.php 8.5. Файл server_check.php →

creating_file_lang

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Dec 2025 12:38:12 +0000

8.3. Файл lang.php

Файл перевода модуля установки. Количество языков перевода зависит только от желания автора проекта и определяется количеством файлов перевода. Для модуля установки нами было запланировано 2а языка, английский и русский.

Создадим файл lang.php в нашей директории /library/install
Создадим вложенную директорию lang в директории /library/install
Создадим файлы lang_en.php и lang_ru.php в директории lang

Файлы перевода

lang_en.php

<?php
/* 
------------------
Language: English
------------------
*/
 
//определяем $lang как массив.
$lang = array();
// задаем значения ключ/перевод
 
$lang['INSTALL_APP_NAME'] = 'UCMS Kernel Installation';
//Language and time zone settings 
$lang['SELECT_APP_LANG'] = 'Select application language:';
$lang['ENGLISH'] = 'English';
$lang['RUSSIAN'] = 'Russian';
$lang['SELECT_TIME_ZONE'] = 'Select time zone:';
//Database Options
$lang['DATABASE_UPTION'] = 'Database Options';
$lang['DATABASE_SERVER_MAN'] = 'Database Management System Server';
$lang['DATABASE_SERVER'] = 'Server: localhost';
$lang['DATABASE_USER'] = 'Database user';
$lang['DATABASE_NAME'] = 'Name:Login to connect to the database';
$lang['DATABASE_PASS'] = 'Password::Login to connect to the database';
//Database
$lang['DATABASE'] = 'Database';
$lang['DATABASE_NAME_UCMS'] = 'Database name: (UCMS)';
//Administrator Settings
$lang['ADMIN_SETTING'] = 'Administrator Settings';
$lang['ADMIN_LOGIN'] = 'Login admin';
$lang['ADMIN_PASS'] = 'Password admin';
$lang['ADMIN_PASS_CONFIRM'] = 'Confirm password admin';
$lang['ADMIN_PASS_EMAIL'] = 'Email admin';
?>

lang_ru.php

<?php
/* 
------------------
Language: Russian
------------------
*/
//определяем $lang как массив.
$lang = array();
// задаем значения ключ/перевод
 
$lang['INSTALL_APP_NAME'] = 'Установка UCMS Kernel'; 
//Параметры языка и часового пояса
$lang['SELECT_APP_LANG'] = 'Выберите язык приложения:';
$lang['ENGLISH'] = 'Английский';
$lang['RUSSIAN'] = 'Русский';
$lang['SELECT_TIME_ZONE'] = 'Выберите часовой пояс:';
//Параметры базы данных
$lang['DATABASE_UPTION'] = 'Параметры базы данных';
$lang['DATABASE_SERVER_MAN'] = 'Сервер системы управления базами данных';
$lang['DATABASE_SERVER'] = 'Сервер: localhost';
$lang['DATABASE_USER'] = 'Пользователь базы данных';
$lang['DATABASE_NAME'] = 'Имя:Логин для соединения с базой данных';
$lang['DATABASE_PASS'] = 'Пароль:Пароль для соединения с базой данных';
//База данных
$lang['DATABASE'] = 'База данных';
$lang['DATABASE_NAME_UCMS'] = 'Имя базы данных: (UCMS)';
//Параметры администратора
$lang['ADMIN_SETTING'] = 'Параметры администратора';
$lang['ADMIN_LOGIN'] = 'Логин администратора';
$lang['ADMIN_PASS'] = 'Пароль администратора';
$lang['ADMIN_PASS_CONFIRM'] = 'Повторить пароль администратора';
$lang['ADMIN_PASS_EMAIL'] = 'Электронная почта администратора';
?>

Файл lang_test.php

Файл lang_test.php сначало проверит наличие файла config.ini и выведет соответствующее сообщение. Следом прочтет файл config.ini

ЕСЛИ файл config.ini прочитан получим для переменной $defaul_lang_user значение языка в настройках
ЕСЛИ значение языка в config.ini пустое место, то проверим директорию lang на наличие файлов перевода и подключим первый файл перевода.
ИНАЧЕ подключим файл перевода, имя которого указанно в файле config.ini

lang_test.php

<!-- test/lang_test.php -->
 
<?php
/* подключим файл с константами, для определения корневой директории приложения */
require_once __DIR__ . "../../../includes/cons.php";
 
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.ini' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
	/* Если config.ini существует */
        if (file_exists($file_config)) {
	/* выводим запись о существовании */
			echo "Файл $file_config существует". "<br/>";
	/* Иначе выводим запись о не существовании*/
		} else {
			echo "Файл $file_config не существует". "<br/>";
		}
//загружаем ini-файл, и возвращаем его настройки в виде ассоциативного массива
$config_defaul_lang = parse_ini_file(FOLDER . "/includes/config.ini",true);
// Проверьте, успешно ли прочитан ini-файл.
// переменная $config_defaul_lang не ровно ЛОЖЬ
if ($config_defaul_lang !== false) {	
    // Доступ к индивидуальным настройкам
	$defaul_lang_user = $config_defaul_lang['defaul_lang']['defaul_lang'];
	if ($defaul_lang_user == ""){
echo "Ошибка чтения INI-файла. выбираем из наличия в папке /lang";	
//Проверка наличия языковых файлов в директории /lang/
$dir = INSTALL . "/lang/";
//Возвращает массив (array), содержащий имена файлов и каталогов
$source = scandir($dir);
// Создадим массив - фильтр для исключения '..', '.'
$filter = ['..', '.'];
//В массиве с результатом функция scandir также покажет наличие папок с именами ".." и ".". 
//Технически первое имя соответствует ссылке на родительскую папку, а второе - на текущую.
// Сравним массивы
$files = array_diff($source, $filter);
//Извлекает первый элемент массива
$lang_one = array_shift($files);
// выведем оставшийся массив
print_r($files);
		echo "Первый элемент массива это:" . $lang_one;
		// Подключаем полученную страницу с переводом
		include_once 'lang/' . $lang_one;
		echo $lang['INSTALL_APP_NAME'];
		echo $lang['SELECT_TIME_ZONE'];
	}	  
 else {
	    echo "Конфигурация по умолчанию: " . $defaul_lang_user . "<br/>";
	  	// Подключаем полученную страницу с переводом
		include_once 'lang/' . $defaul_lang_user . '.php';
		// Выведем перу переводов для теста
		echo $lang['INSTALL_APP_NAME'];
		echo $lang['SELECT_TIME_ZONE'];
}
}

Создадим в config.ini тестовую запись выбора файла перевода пользователем lang_ru и создадим в директории lang пустой файл для французкого перевода lang_fr.php

config.ini

[defaul_lang]
; default configuration
defaul_lang = lang_ru

Откроем файл lang_test.php в браузере:

Получаем сообщение о существовании файла config.ini, а так же значение переменной defaul_lang = lang_ru и вывод двух тестовых фраз на русском языке.

Изменив в настройках файл перевода на lang_en получаем тестовые фразы на английском

Если файл перевода в config.ini не указан, то получаем сообщение Ошибка чтения INI-файла., проверяется директория /lang и выбираем первый файл, а это lang_en.php из массива, где еще присутствуют lang_fr.php и lang_ru.php. Тестовые фразы соответственно на английском.

Файл lang.php

Сам файл lang.php в законченном виде нам ничего выводить не будет, т.к. в нем заключена логика выбора файла перевода. Логику выбора файла перевода из директории вынисем в отдельную функцию check_lang_install() чтобы не прописывать код дважда (для отсутствия config.ini и для defaul_lang=пустое значение)

lang.php

<?php
//echo "это lang";
 
/* подключим файл с константами, для определения корневой 
 *директории приложении и файлов конфигурации и функций */
require_once __DIR__ . "../../../includes/cons.php";
 
//////////////////////////////////////////////////////////
// Создадим функцию для выбора первого файла и директории
function check_lang_install() {
$dir = INSTALL . "/lang/";
//Возвращает массив (array), содержащий имена файлов и каталогов
$source = scandir($dir);
// Создадим массив - фильтр для исключения '..', '.'
$filter = ['..', '.'];
//В массиве с результатом функция scandir также покажет наличие папок с именами ".." и ".". 
//Технически первое имя соответствует ссылке на родительскую папку, а второе - на текущую.
// Сравним массивы
$files = array_diff($source, $filter);
//Извлекаем первый элемент массива
$lang_one = array_shift($files);
		// Подключаем полученную страницу с переводом
		include_once 'lang/' . $lang_one;
}
//////////////////////////////////////////////////////////
 
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.ini' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
	/* Если config.ini существует */
        if (file_exists($file_config)) {
//загружаем ini-файл, и возвращаем его настройки в виде ассоциативного массива
$config_defaul_lang = parse_ini_file(FOLDER . "/includes/config.ini",true);
// Проверьте, успешно ли прочитан ini-файл.
// переменная $config_defaul_lang не ровно ЛОЖЬ
if ($config_defaul_lang !== false) {	
    // Доступ к индивидуальным настройкам
	$defaul_lang_user = $config_defaul_lang['defaul_lang']['defaul_lang'];
	if ($defaul_lang_user == ""){
		//подключим функцию выбора файла из директории
		check_lang_install();		
	}	  
	else {
	  	// Подключаем полученную страницу с переводом
		include_once 'lang/' . $defaul_lang_user . '.php';
	}
}
}
		else {
		//подключим функцию выбора файла из директории
		check_lang_install();	
		}
?>

Т.к. install.php у нас является отдельным модулем, то и файлы перевода мы создаем только для этого мадуля в директори /install, больше они нам ни где не пригодятся, а так же функцию выбора мы не выносим в function.php, т.к. выбираем файл в директории модуля install.php

← 8.2. Файл index.php 8.4. Файл lang_and_time_zone.php →

creating_file_module_help

anonymous@undisclosed.example.com (Anonymous) — Sun, 04 May 2025 12:39:27 +0000

8.6. Файл module_help.php

Это не исполнительный файл. Он просто выводит справочную информацию о модулях и расширениях, используемых нашим приложением.

Сейчас это страница с расширением .php, но по сути это одностраничный html - документ, который будет открываться в новом окне. Позже в него будет подключена функция перевода.

Создание

Создадим в директории /ucms/library/install Файл module_help.php и запишем в него следующий код

module_help.php

<!DOCTYPE html>
<html>
<head> 
<meta charset="UTF-8">
<title>module_help.php</title> 
</head>
<body> 
<table>
	<tr>
		<td>
			<b>Bzip2 Function</b> - используются для прозрачного чтения и записи сжатых файлов bzip2 (.bz2).
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>cURL Module</b> - позволяет подключаться и взаимодействовать со многими различными типами серверов с помощью многих различных типов протоколов (http, https, ftp, gopher, telnet, dict, file и ldap).
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>GD Library</b> - позволяет использовать функции изображений, включая создание и обработку файлов изображений в различных форматах, включая GIF , PNG , JPEG , WBMP и XPM.
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>DOM Extension</b> - позволяет выполнять операции с документами XML и HTML через API DOM с PHP.
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>LDAP Protocol</b> - облегченный протокол доступа к каталогам, который используется для доступа к «серверам каталогов».
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>MySQLi Extension</b> - позволяет получить доступ к функциональным возможностям MySQL 4.1 и выше.
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>OpenSSL Extension</b> - используются для симметричного и асимметричного шифрования и дешифрования, PBKDF2, PKCS7, PKCS12, X509 и других криптоопераций. 
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>PDO Extension</b> - определяет легкий, последовательный интерфейс для доступа к базам данных в PHP.
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>PDO_SQLITE Driver</b> - драйвер, реализующий интерфейс PHP Data Objects (PDO) для обеспечения доступа к базам данных SQLite 3.
		</td>
	</tr>
	<tr>
	<tr>
		<td>
			<b>SimpleXML Extension</b> - предоставляет очень простой и удобный набор инструментов для преобразования XML в объект, который можно обрабатывать с помощью обычных селекторов свойств и итераторов массивов.
		</td>
	</tr>
	<tr>	
	<tr>
		<td>
			<b>SQLite3 Module</b> - поддержка баз данных SQLite версии 3.
		</td>
	</tr>
	<tr>
		<td>
			<b>Zip Extension</b> - позволяет прозрачно читать или записывать сжатые ZIP-архивы и файлы внутри них.
		</td>
	</tr>
	<tr>
		<td>
			<b>Zlib Module</b> - позволяет прозрачно читать и записывать сжатые gzip (.gz) файлы с помощью версий большинства функций файловой системы , которые работают с файлами, сжатыми gzip
		</td>
	</tr>	
</table> 
<p style="color: green"> Более подробная информация на официальном <a href="https://www.php.net/manual/index.php"> сайте php.net</a></p>
</body>
</html>

← 8.5. Файл server_check.php 8.7. Файл install.php →

creating_file_server_check

anonymous@undisclosed.example.com (Anonymous) — Sun, 04 May 2025 11:45:49 +0000

8.5. Файл server_check.php

Введение

Файл server_check.php - исполнительный файл, который будет проверять наш веб-сервер, а именно:

Версия PHP,
Версия Apache http server,
Наличие установленной версии системы управления базами данных MySQL,
Модули и библиотеки PHP
Права на чтение/запись в папки и файлы
Отсутствие файла конфигурации

Так-же этот файл будет иметь функцию вывода информации (отображение данных файла module_help.php) о необходимых модулях и логику поведения приложения при разных действиях пользователя.

Подготовка

Создадим в директории /test вложенную директорию img для хранения и вывода иконок. В ней мы сохраним файлы иконок OK, ERROR и Refresh нашего установщика: , , .

Основная часть файла это перечисление, оформленное в таблице - структурированного набора данных, состоящего из строк и столбцов, внутри которой помещен заголовок и код запросов PHP.

<table>
    <tr>
		<td>
			Наименование модуля
		</td>
		<td>
			<?php echo "" . PHP_OS ; ?>
		</td>
	</tr>	
</table>

<table> - основной тег HTML, определяющий начало таблицы.
<tr> - основной тег HTML, определяющий начало строки таблицы.
<td> - основной тег HTML, определяющий начало ячейки таблицы.
<?php - открывающий тег PHP.
?> - закрывающий тег PHP.
</td> - основной тег HTML, определяющий конец ячейки таблицы.
</tr> - основной тег HTML, определяющий конец строки таблицы.
</table> - основной закрывающий тег HTML, определяющий конец таблицы.

			<span class="table_block_install"><b>
			<?php
			/* Выводим версию веб-сервера Apache */
			echo $_SERVER['SERVER_SOFTWARE'];
			echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
			?></b>
			</span>

<span ...> - начало строкового контейнера.
<b> - начало жирного выделения текста.
<?php - открывающий тег PHP.
<echo> - конструкция в PHP для вывода объектов.
$_SERVER[] - встроенный массив, содержащий информацию о сервере, окружении и текущем запросе пользователя.
'SERVER_SOFTWARE' - строка идентификации сервера, указанная в заголовках, когда происходит ответ на запрос.
<img src="" - атрибут, определяет местонахождение (URL) изображения.
alt="" - атрибут тега img описания изображение.
width="" - атрибут, определяет ширину блочных или заменяемых элементов (изображения).
height="" - атрибут, определяет высоту блочных или заменяемых элементов (изображения).
?> - закрывающий тег PHP.
</b> - конец жирного выделения текста.
</span> - конец строкового контейнера.

Пимечание:
Код приведенный ниже, является основным строковым контейнером для фразового контента, что по своей сути, является всего лишь оберткой, к классу table_block_install позже будут подключенны стили ранее созданного (пока пустого) файла install.css в директории css.

 
	<span class="table_block_install">
	</span>

«Наименование модуля» логично расположить в ячейке по левому краю формы, а контейнер «кода запросов PHP» отодвинуть, задав растояние, по правому. Это мы позже и пропишем в файле install.css.

Запросы

Ниже приведен основной перечень выводов запросов к серверу, который нами будет использоваться для отображения информации в таблице

echo PHP_OS;
echo $_SERVER['SERVER_SOFTWARE'];
echo PHP_VERSION;
print_r(get_loaded_extensions());
echo phpversion('curl');
echo substr(sprintf('%o', fileperms('/tmp')), -4);

PHP_OS - константа вывода только названия операционной системы.
SERVER_SOFTWARE - идентификатор сервера.
PHP_VERSION - информация о версии PHP.
(get_loaded_extensions()) - возвращение массива имён скомпилированных и загруженных модулей.
phpversion('curl') - возвращает версию загруженного модуля, в примере: curl
fileperms — возвращает информацию о правах на файл

Блок логики версии PHP

Нами будет использоваться при написании приложения версия PHP не ниже 8.2

Логический операторы условия ЕСЛИ (if) и ИНАЧЕ (else) расмотрены в предыдущей главе 8.5. Файл server_check.php. В коде, приведенном ниже мы добавим тип данных с двумя возможными значениями: true (истина) и false (ложь).

<?php
/* Выводим версию установленного PHP */
/* Проверим, что версия установленного PHP не ниже 8.2 */
if (version_compare(PHP_VERSION, '8.2.0') >= 0) {
	echo 'Версия PHP: ' . PHP_VERSION . '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
	/* Иначе выводим просьбу обновить PHP*/
	} else {
	echo 'Обновите версию PHP ' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
	/* Присвоим переменной $install_error значение true */
	/* т.е. ошибка установки - истина */
	$install_error = true;
	}
?>

version_compare() - сравнивает две «PHP-стандартизованные» строки с номерами версий.

Мы проверяем, что ЕСЛИ установленная версия PHP не ниже версии 8.2.0, тогда выводим сообщение: Версия PHP: номер установленной версии и иконку OK из директории /img c заданным размером 18×18, ИНАЧЕ выводим сообщение об ошибке: Обновите версию PHP, иконку ERROR из директории /img c заданным размером и переменной $install_error присваиваем значение true (истина).

Блок логики проверки модулей PHP

Мы рассмотрим принцип работы кода только для одного модуля cURL, остальные будет прописанны по этому шаблону.

<?php
/* Проверим включен ли модуль cURL Module*/
$extensions = get_loaded_extensions();
	if (!in_array('curl', $extensions)) {
	/* Когда cURL Module у нас выключен, 
	выводиться сообщение о невозможности продолжить,
	появляется ссылка кнопка на эту же страницу "Обновить"*/
	echo "Включите cURL Module:";
	echo '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
	/* Присвоим переменной $install_error значение true */
	/* т.е. ошибка установки - истина */
	$install_error = true;
	}
	else {
	echo 'Установлено: ' . phpversion('curl');
	echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
	}
?>

$extensions = get_loaded_extensions(); - присвоим переменной $extensions значение

возвращения массива имён загруженных модулей.

in_array('curl', $extensions) - функция выполняет поиск значения curl в массиве, заданном переменной $extensions
! перед in_array() - означает отрицание, т.е, что не в массиве

Проверяем: ЕСЛИ curl не в массиве заданном переменной $extensions, тогда выводим сообщение: Включите cURL Module:, отображается иконка ERROR из директории /img c заданным размером и переменной $install_error присваиваем значение true (истина), ИНАЧЕ выводим сообщение: Установлено:, номер версии curl и иконку OK.

Блок логики проверки прав доступа

В этом блоке нам необходимо проверить, что директория, в которую приложение будет записывать данные, доступна для записи. К основным относятся:

0600 - Доступ на запись и чтение для владельца, нет доступа для других
0644 - Доступ на запись и чтение для владельца, доступ на чтение для других
0750 - Полный доступ для владельца, доступ на чтение и выполнение для группы владельца
0755 - Полный доступ для владельца, доступ на чтение и выполнение для других
0777 - Полный доступ для всех

Пимечание:
Права доступа для проверки кода можно изменить командой

chmod("./includes/demo/", 0644);

Рассмотрим блок проверки прав доступа

<?php
/* Проверим разрешения для папок */
$dir_includes = substr(sprintf('%o', fileperms('../includes/demo')), -4);
if ($dir_includes == '0775') {
		echo '/demo доступна для записи';
		echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
	} else {
		echo '/demo  недоступна для записи' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
		/* Присвоим переменной $install_error значение true */
		/* т.е. ошибка установки - истина */
		$install_error = true;
	}
?>

$dir_includes - переменная, которой присвоим значение: отображение прав доступа в виде восьмеричного числа
substr() - функция, которая вырезает и возвращает подстроку из строки
sprintf() - функция, которая возвращает отформатированную строку
fileperms() - возвращает информацию о правах доступа на файл

Проверка: ЕСЛИ переменная $dir_includes ровняется 0775, тогда выводим сообщение: /demo доступна для записи и отобразим иконку OK. ИНАЧЕ выводим сообщение: /demo недоступна для записи, отображаем иконку ERROR и переменной $install_error присваиваем значение true (истина).

Блок логики переменной $install_error

Данный блок необходим для вывода справочной информации по необходимым приложению модулям и расширениям, отображения сообщения:Невозможно продолжить. Исправьте ошибки и Обновите страницу, а так-же в случае успеха отобразить кнопку «Продолжить».

Пимечание:
В блоках кода проверки выше, мы в случае ошибки присваивали переменной $install_error значение true

$install_error = true;

<?php
// Если переменная $install_error хотя бы раз приняла 
// значение true, то выведим сообщение 
//Более подробную информацию о необходимых модулях можно найти на странице требований.
//Невозможно продолжить. Исправьте ошибки и попробуйте еще раз. Обновить
if ($install_error == true) {
echo 'Более подробную информацию о необходимых модулях можно найти на ' . '<a href="./test_99.php" target="_blank">странице требований</a>';
echo '<p style="color: red"> Невозможно продолжить. Исправьте ошибки и ' . '<a href="./test_4.php"> Обновите страницу</a>' . '</p>' . '<br/>';
} else {
	/* Если значение переменной $install_error значение не равно true */
	/* тогда выведим кнопку Продолжить */
	echo '	<div class = "install_button">
	<form action="database_options.php">
	<input type="submit" value="Продолжить" name="button">
	</form>
	</div>';
  } 
?>

Проверка: ЕСЛИ переменной $install_error присвоено значение true, тогда выводим сообщение: Более подробную информацию о необходимых модулях можно найти на, ссылка на страницу требований. ИНАЧЕ выводим блок кнопки «Продолжить» с активацией страницы конфигурации приложения.

Файл test_4.php

В директорию добавим тестовый файл test_4.php и записываем в него разобранный в этой главе код вывода запросов

test_4.php

<!--  test_4.php  -->
 
<table>
    <tr>
		<td>
		Server OS:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим имя операционной системы сервера */
			echo PHP_OS;
			?></b>
			</span>
		</td>
	</tr>
	<tr>
		<td>
		Web server:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим версию веб-сервера Apache */
			echo $_SERVER['SERVER_SOFTWARE'];
			echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
			?></b>
			</span>
		</td>
	</tr>
	<tr>
		<td>
		PHP ver. > 8.2
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим версию установленного PHP */
			/* Проверим, что версия установленного PHP не ниже 8.2 */
			if (version_compare(PHP_VERSION, '8.2.0') >= 0) {
				echo 'Версия PHP: ' . PHP_VERSION . '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				/* Иначе выводим просьбу обновить PHP*/
				} else {
				echo 'Обновите версию PHP ' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		cURL Module:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  pgsql Module, 
			SimpleXML Module, PDO bz2 zlib sqlite3 zip mysqli*/
			$extensions = get_loaded_extensions();
				if (!in_array('curl', $extensions)) {
				/* Когда cURL Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo "Включите cURL Module:";
				echo '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('curl');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>			
    <tr>
		<td>
		Folder Permissions:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим разрешения для папок */
			$dir_includes = substr(sprintf('%o', fileperms('../includes/demo')), -4);
				if ($dir_includes == '0775') {
					echo "$dir_includes" . '/demo доступна для записи';
					echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				} else {
					echo "$dir_includes" . ' - /demo  недоступна для записи' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
					/* Присвоим переменной $install_error значение true */
					/* т.е. ошибка установки - истина */
					$install_error = true;
				}
				?></b>
				</span>
			</td>
		</tr>	
</table>
<?php
// Если переменная $install_error хотя бы раз приняла 
// значение true, то выведим сообщение 
//Более подробную информацию о необходимых модулях можно найти на странице требований.
//Невозможно продолжить. Исправьте ошибки и попробуйте еще раз. Обновить
if ($install_error == true) {
echo 'Более подробную информацию о необходимых модулях можно найти на ' . '<a href="./test_99.php" target="_blank">странице требований</a>';
echo '<p style="color: red"> Невозможно продолжить. Исправьте ошибки и ' . '<a href="./test_4.php"> Обновите страницу</a>' . '</p>' . '<br/>';
} else {
	/* Если значение переменной $install_error значение не равно true */
	/* тогда выведим кнопку Продолжить */
	echo '	<div class = "install_button">
	<form action="database_options.php">
	<input type="submit" value="Продолжить" name="button">
	</form>
	</div>';
  } 
?>

Веведим в веб-браузере наш файл:

Как мы можем видеть, версия PHP у нашего сервера установлена ниже требуемой и часть модулей отключена (не установлена). При этом для тестовой директории demo установены права - 0644, что означает доступ на запись и чтение для владельца, доступ на чтение для других

curl для проверки выключен для наглядности примера

Если curl был включен, то система выдала бы «Установлено:,версию и иконку OK»

Файл server_check.php

Откроем в блокноте созданный ранее в директории /ucms/library/install/ файл server_check.php и запишем в него код из файла test_4.php, предварительно, убрав лишнее, а именно:

комментарий <!– test_4.php –>

Добавим в начало файла следующий код PHP:

server_check.php

<?php
include "tpl/tpl_install_header.php";
/* Подключем файл cons.php из директории includes*/
include "../../includes/cons.php";
/* Объявим в переменной $file_config путь к файлу config.php
для файла./ucms/library/install/server_check.php
и проверим его наличие */
$file_config = FOLDER . '/includes/config.php';
/* Если файл config.php в директории /includes существует,
приложение переведет на страницу выбора конфигурации
./ucms/library/install/database_options.php, которая пока у нас не создана*/
if (file_exists($file_config)) {
	/* Вызов header, с задержкой 5 сек перенаправит на страницу
	./ucms/library/install/database_options.php */
    header('Refresh: 5; URL = database_options.php');
    echo "Обнаружена установленная версия приложения!";
	echo "Можно установить дополненительную конфигурацию приложения!";
    exit();
}
?>

include "tpl/tpl_install_header.php"; подключаем файл заголовка нашего окна

Пимечание:
Файл tpl_install_header.php в директории /tpl будет создан позднее в главе 8.7. Файл install.css и сейчас подключается, чтобы в будущем не возвращаться к этой главе.

include "../../includes/cons.php"; подключем файл с константами cons.php из директории includes
$file_config = FOLDER . '/includes/config.php'; задаем переменной $file_config в значение файл config.php в директории includes
header('Refresh: 5; URL = database_options.php'); с задержкой 5 сек перенаправляем пользователя на страницу выбора установки конфигурации database_options.php

Проверка: ЕСЛИ файл $file_config тогда вызов header, с задержкой 5 сек перенаправит на страницу ./ucms/library/install/database_options.php с выводим сообщений: Обнаружена установленная версия приложения!
Можно установить дополненительную конфигурацию приложения! ИНАЧЕ будет выведена таблица проверки сервера.

Далее для необходимых нам модулей по шаблону кода из файла test_4.php, прописываем логику проверки в талице, заменив путь к проверяемой директории с /demo на ../../includes. Модули для проверки могут отличаться, в зависимости от цели создаваемого приложения, в нашем случае это:

Bzip2 Function - используются для прозрачного чтения и записи сжатых файлов bzip2 (.bz2).
cURL Module - позволяет подключаться и взаимодействовать со многими различными типами серверов с помощью многих различных типов протоколов (http, https, ftp, gopher, telnet, dict, file и ldap).
GD Library - позволяет использовать функции изображений, включая создание и обработку файлов изображений в различных форматах, включая GIF , PNG , JPEG , WBMP и XPM.
DOM Extension - позволяет выполнять операции с документами XML и HTML через API DOM с PHP.
LDAP Protocol - облегченный протокол доступа к каталогам, который используется для доступа к «серверам каталогов».
MySQLi Extension - позволяет получить доступ к функциональным возможностям MySQL 4.1 и выше.
OpenSSL Extension - используются для симметричного и асимметричного шифрования и дешифрования, PBKDF2, PKCS7, PKCS12, X509 и других криптоопераций.
PDO Extension - определяет легкий, последовательный интерфейс для доступа к базам данных в PHP.
PDO_SQLITE Driver - драйвер, реализующий интерфейс PHP Data Objects (PDO) для обеспечения доступа к базам данных SQLite 3.
SimpleXML Extension - предоставляет очень простой и удобный набор инструментов для преобразования XML в объект, который можно обрабатывать с помощью обычных селекторов свойств и итераторов массивов.
SQLite3 Module - поддержка баз данных SQLite версии 3.
Zip Extension - позволяет прозрачно читать или записывать сжатые ZIP-архивы и файлы внутри них.
Zlib Module - позволяет прозрачно читать и записывать сжатые gzip (.gz) файлы с помощью версий большинства функций файловой системы , которые работают с файлами, сжатыми gzip

В конец нашего файла добавим следующий код «Прогресс-бара», чтобы пользователь знач, где он в данный момент находиться.

<?php 
<div class="progressbar">
  <span style="width: 40%"></span>
</div>

И в заключение добавим «подвал» нашего окна

include "tpl/tpl_install_footer.php"; подключаем файл «подвала» нашего окна

Пимечание:
Файл tpl_install_footer.php в директории /tpl будет создан позднее в главе 8.7. Файл install.css и сейчас подключается, чтобы в будущем не возвращаться к этой главе.

Оформив правки и собрав воедино все описанное в данной главе записываем в файл server_check.php готовый код

server_check.php

<?php
include "tpl/tpl_install_header.php";
/* Подключем файл cons.php из директории includes*/
include "../../includes/cons.php";
/* Объявим в переменной $file_config путь к файлу config.php
для файла./ucms/library/install/server_check.php
и проверим его наличие */
$file_config = FOLDER . '/includes/config.php';
/* Если файл config.php в директории /includes существует,
приложение переведет на страницу выбора конфигурации
./ucms/library/install/database_options.php, которая пока у нас не создана*/
if (file_exists($file_config)) {
	/* Вызов header, с задержкой 5 сек перенаправит на страницу
	./ucms/library/install/database_options.php */
    header('Refresh: 5; URL = database_options.php');
    echo "Обнаружена установленная версия приложения!";
	echo "Можно установить дополненительную конфигурацию приложения!";
    exit();
}
?>
<table>
    <tr>
		<td>
		Server OS:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим имя операционной системы сервера */
			echo "" . PHP_OS ;
			?></b>
			</span>
		</td>
	</tr>
	<tr>
		<td>
		Web server:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим версию веб-сервера Apache */
			echo $_SERVER['SERVER_SOFTWARE'];
			echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
			?></b>
			</span>
		</td>
	</tr>
	<tr>
		<td>
		PHP ver. > 8.2
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Выводим версию установленного PHP */
			/* Проверим, что версия установленного PHP не ниже 8.2 */
			if (version_compare(PHP_VERSION, '8.2.0') >= 0) {
				echo 'Версия PHP: ' . PHP_VERSION . '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				/* Иначе выводим просьбу обновить PHP*/
				} else {
				echo 'Обновите версию PHP ' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		cURL Module:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  pgsql Module, 
			SimpleXML Module, PDO bz2 zlib sqlite3 zip mysqli*/
			$extensions = get_loaded_extensions();
				if (!in_array('curl', $extensions)) {
				/* Когда cURL Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo "Включите cURL Module:";
				echo '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('curl');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		GD Library:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  GD Library*/
			$extensions = get_loaded_extensions();
				if (!in_array('gd', $extensions)) {
				/* Когда GD Library Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo "Включите GD Library Module:";
				echo '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('gd');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		SQLite3 Module:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  sqlite3*/
			$extensions = get_loaded_extensions();
				if (!in_array('sqlite3', $extensions)) {
				/* Когда sqlite3 Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите sqlite3 Module' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('sqlite3');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		Zip Extension
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  ZipArchive*/
			$extensions = get_loaded_extensions();
				if (!in_array('zip', $extensions)) {
				/* Когда Zip Extension у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите Zip Extension' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('zip');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		PDO Extension
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли PDO Extension*/
			$extensions = get_loaded_extensions();
				if (!in_array('PDO', $extensions)) {
				/* Когда PDO Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите PDO Extension' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('PDO');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>
    <tr>
		<td>
		SimpleXML Extension:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  SimpleXML Extension*/
			$extensions = get_loaded_extensions();
				if (!in_array('SimpleXML', $extensions)) {
				/* Когда SimpleXML Extension у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите SimpleXML Extension' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('SimpleXML');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>			
    <tr>
		<td>
		Bzip2 Function:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  Bzip2 Function*/
			$extensions = get_loaded_extensions();
				if (!in_array('bz2', $extensions)) {
				/* Когда Bzip2 Function у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите Bzip2 Function' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('bz2');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>	
    <tr>
		<td>
		Zlib Module:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли модуль  Zlib Module*/
			$extensions = get_loaded_extensions();
				if (!in_array('zlib', $extensions)) {
				/* Когда Zlib Module у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите Zlib Module' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('zlib');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>				
    <tr>
		<td>
		MySQLi Extension:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли MySQLi Extension*/
			$extensions = get_loaded_extensions();
				if (!in_array('mysqli', $extensions)) {
				/* Когда MySQLi Extension у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите MySQLi Extension' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('mysqli');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>			
    <tr>
		<td>
		PDO_SQLITE Driver:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли PDO_SQLITE Driver*/
			$extensions = get_loaded_extensions();
				if (!in_array('pdo_sqlite', $extensions)) {
				/* Когда PDO_SQLITE Driver у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите PDO_SQLITE Driver' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('pdo_sqlite');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>				
    <tr>
		<td>
		LDAP Protocol:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли LDAP Protocol*/
			$extensions = get_loaded_extensions();
				if (!in_array('ldap', $extensions)) {
				/* Когда LDAP Protocol у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите LDAP Protocol' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('ldap');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>				
    <tr>
		<td>
		OpenSSL Extension:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим включен ли OpenSSL Extension*/
			$extensions = get_loaded_extensions();
				if (!in_array('openssl', $extensions)) {
				/* Когда OpenSSL Extension у нас выключен, 
				выводиться сообщение о невозможности продолжить,
				появляется ссылка кнопка на эту же страницу "Обновить"*/
				echo 'Включите OpenSSL Extension' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
				/* Присвоим переменной $install_error значение true */
				/* т.е. ошибка установки - истина */
				$install_error = true;
				}
				else {
				echo 'Установлено: ' . phpversion('openssl');
				echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				}
			?></b>
			</span>
		</td>
	</tr>					
    <tr>
		<td>
		Folder Permissions:
		</td>
		<td>
			<span class="table_block_install"><b>
			<?php
			/* Проверим разрешения для папок */ 
			$dir_includes = substr(sprintf('%o', fileperms('../../includes')), -4);
				if ($dir_includes == '0775') {
					echo '/includes доступна для записи';
					echo '<img src="img/good_green_ucms_creat_5.png" alt="good_green" width="18" height="18">';
				} else {
					echo '/includes  недоступна для записи' . '<img src="img/close_red_ucms_creat_5.png" alt="close_red" width="18" height="18">';
					/* Присвоим переменной $install_error значение true */
					/* т.е. ошибка установки - истина */
					$install_error = true;
				}
				?></b>
				</span>
			</td>
		</tr>	
</table>
<?php
// Если переменная $install_error хотя бы раз приняла 
// значение true, то выведим сообщение 
//Более подробную информацию о необходимых модулях можно найти на странице требований.
//Невозможно продолжить. Исправьте ошибки и попробуйте еще раз. Обновить
if ($install_error == true) {
echo 'Более подробную информацию о необходимых модулях можно найти на ' . '<a href="./module_help.php" target="_blank">странице требований</a>';
echo '<p style="color: red"> Невозможно продолжить. Исправьте ошибки и ' . '<a href="./server_check.php"> Обновите страницу</a>' . '</p>' . '<br/>';
} else {
	/* Если значение переменной $install_error значение не равно true */
	/* тогда выведим кнопку Продолжить */
	echo '	<div class = "install_button">
	<form action="options.php">
	<input type="submit" value="Продолжить" name="button">
	</form>
	</div>';
  } 
?>
 
<div class="progressbar">
  <span style="width: 40%"></span>
</div>
<?php
include "tpl/tpl_install_footer.php";
?>

Создадим в директории /ucms/library/install новый каталог для картинок и назовем его, к примеру - img, в нем мы будем хранить файлы иконок нашего установщика. Поместим в директорию /img файлы иконок OK, ERROR и Refresh.

Переместим файл config.php в директорию demo. И откроем файл server_check.php в браузере

При нажатии на ссылку «Обновите страницу» у нас обновиться страница в этом же окне, а при нажатии на ссылку «странице требований» откроется страница файла module_help.php в новом окне (за это отвечает target="_blank"), которая будет создана нами в следующей главе 8.6. Файл module_help.php

Обновим PHP до версии ⇒ 8.2 на нашем сервере и установим (включим) недостоющие модули и библиотеки, и нажмем ссылку «Обновите страницу»

Переместим назад файл config.php из директории demo. И откроем файл server_check.php в браузере

И через 5 сек нас перенаправит на следющее окно файла создания пользователя базы данных, который будет создан позднее.

← 8.4. Файл lang_and_time_zone.php 8.6. module_help.php →

creating_install

anonymous@undisclosed.example.com (Anonymous) — Sun, 04 May 2025 14:20:57 +0000

8.7. Файл install.php

Файл install.php будет являтся главным файлом установщика нашего приложения. В этот файл уже будут подключаться другие файлы и стили.

Файл test_5.php

В директорию test добавим новый тестовый файл test_5.php и записываем в него следубщий код:

test_5.php

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>Установка UCMS Demo</title>
    <!--  Начало стилей установщика, мы не выносим стили в отдельный файл, т.к.
          эти стили нужны только в этом файле. После установки приложения эта папка 
    будет удалена.	-->
  <style type="text/css">
   .block_install {
	width: 700px; /* Ширина содержимого в рамке */
 
    position: absolute;  /* Абсолютное позиционирование */
    left: 0; /* Положение от левого края */
    right: 0; /* Положение от правого края */
    margin: auto;  /* Отступы вокруг элемента */
 
   }
   .block_window_install{
    border: 2px #808080 solid; /* Параметры рамки: ширина, цвет, сплошная граница */
    background: #e3ffec; /* Цвет фона */
	border-radius: 5px; /* закругленные края рамки */
	padding: 10px; /*  со всех сторон отступ 10px */
	box-shadow: 0 15px 25px -4px rgba(0, 0, 0, 0.5);  /* тень вокруг элемента */ 	
   }
   .block_install_name {
	font-size: 18px; /* Размер текста */ 
	font-style: italic; /* Наклонный текст */ 
    font-weight: 700; /* Жирный текст */ 
    color: #808080; /* Цвет текста */ 
   }
   .footer_install {	 
    text-align: center; /* Раположение текста по центру */
	font-size: 14px; /* Размер текста */ 
	font-style: italic; /* Наклонный текст */ 
    font-weight: 700; /* Жирный текст */ 
    color: #808080; /* Цвет текста */
   }
   .table_block_install{
	padding: 0px 0px 0px 300px;	 /* отступ блока вправо*/
   }
  </style>
    <!--  Конец стилей установщика	-->
  </head>
  <body> 
    <!--  Начало блока рамки установщика -->
    <div class="block_install">
        <div class="block_window_install">
        <!--  Начало блока названия программы -->
            <div class="block_install_name">
        		Установка UCMS Demo
            </div>
		<!--  Конец блока названия программы -->
		<!--  Начало блока вставки файлов программы -->
    	<table>
            <tr>
				<td>
				PHP-версия
				</td>
				<td>
				<span class="table_block_install"><b>8.2.21</b>- ОК</span>
				</td>
			</tr>
			<tr>
				<td>
				Apache web server
				</td>
				<td>
				<span class="table_block_install"><b>Apache/2.4.58 (Unix)</b>- ОК</span>
				</td>
			</tr>
		</table>
		<!--  Конец блока вставки файлов программы -->
		<p class="hint">
		Более подробную информацию о необходимых модулях можно найти на 
		<a href="https://github.com/UniversalCMS-CE/" target="_blank">странице требований.</a>
		</p>
		<p>
		Невозможно продолжить. Исправьте ошибки и попробуйте еще раз. 
		<!--  Кнопка обновления страницы, переход на саму себя -->
		<a href="./install.php">Обновить</a>
		</p>
		</div>
		<!--  Начало нижнего колонтитула -->
		<div class="footer_install">
    			<p>
				Author:
				<a href="mailto:PolskiyVN@gmail.com"> VladPolskiy</a>  © 2024-2025  
				<a href="https://UniversalCMS-ce.ovh/" target="_blank"> UniversalCMS CE </a>
				– Ver: 1.2.10
				</p> 
		</div>
		<!--  Конец нижнего колонтитула -->
		 </div>
		<!--  Конец блока рамки установщика -->		
 </body>
</html>

Отобразим файл test_5.php в веб - браузере

В данном примере мы разработали шаблон страницы установщика, написанный с помощью языка разметки HTML и стилей CSS. В нем прописан код, разобранный в придыдущих главах. При жедании ознакомиться с версткой сайта предгается прочитать краткое руководство по Адаптивной вёрстке сайта (теория и практика)

Наше же приложение будет разделено на 3 части и будет иметь:

«Верхний колонтитул (голова)» файл tpl_install_header.php
«Окно» где будут выводиться данные из других файлов.
«Нижний колонтитул (подвал)» файл tpl_install_footer.php

tpl дирректория и шаблоны

Создадим в директории ./ucms/library/install/ вложенную директорию /tpl/ для наших шаблонов, а так-же два файла tpl_install_header.php и tpl_install_footer.php в новой директории.

В файл tpl_install_header.php вынесем из файла test_5.php код от начала страницы до конца комментария


tpl_install_header.php

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>Установка UCMS Demo</title>
    <!--  Начало стилей установщика, мы не выносим стили в отдельный файл, т.к.
          эти стили нужны только в этом файле. После установки приложения эта папка 
    будет удалена.	-->
  <style type="text/css">
   .block_install {
	width: 700px; /* Ширина содержимого в рамке */
 
    position: absolute;  /* Абсолютное позиционирование */
    left: 0; /* Положение от левого края */
    right: 0; /* Положение от правого края */
    margin: auto;  /* Отступы вокруг элемента */
 
   }
   .block_window_install{
    border: 2px #808080 solid; /* Параметры рамки: ширина, цвет, сплошная граница */
    background: #e3ffec; /* Цвет фона */
	border-radius: 5px; /* закругленные края рамки */
	padding: 10px; /*  со всех сторон отступ 10px */
	box-shadow: 0 15px 25px -4px rgba(0, 0, 0, 0.5);  /* тень вокруг элемента */ 	
   }
   .block_install_name {
	font-size: 18px; /* Размер текста */ 
	font-style: italic; /* Наклонный текст */ 
    font-weight: 700; /* Жирный текст */ 
    color: #808080; /* Цвет текста */ 
   }
   .footer_install {	 
    text-align: center; /* Раположение текста по центру */
	font-size: 14px; /* Размер текста */ 
	font-style: italic; /* Наклонный текст */ 
    font-weight: 700; /* Жирный текст */ 
    color: #808080; /* Цвет текста */
   }
   .table_block_install{
	padding: 0px 0px 0px 300px;	 /* отступ блока вправо*/
   }
  </style>
    <!--  Конец стилей установщика	-->
  </head>
  <body> 
    <!--  Начало блока рамки установщика -->
    <div class="block_install">
        <div class="block_window_install">
        <!--  Начало блока названия программы -->
            <div class="block_install_name">
        		Установка UCMS Demo
            </div>
		<!--  Конец блока названия программы -->
		<!--  Начало блока вставки файлов программы -->

В файл tpl_install_footer.php вынесем из файла test_5.php код от комментария
 до конца страницы

tpl_install_footer.php

		<!--  Конец блока вставки файлов программы -->
 
		</div>
		<!--  Начало нижнего колонтитула -->
		<div class="footer_install">
    			<p>
				Author:
				<a href="mailto:PolskiyVN@gmail.com"> VladPolskiy</a>  © 2024-2025  
				<a href="https://UniversalCMS-ce.ovh/" target="_blank"> UniversalCMS CE </a>
				– Ver: 1.2.10
				</p> 
		</div>
		<!--  Конец нижнего колонтитула -->
		 </div>
		<!--  Конец блока рамки установщика -->		
 </body>
</html>
</html>

Файл install.php

Открываем наш ранее созданный файл install.php и записываем в него три строчки кода PHP.

install.php

<?php include "tpl/tpl_install_header.php"; ?>
 
	<?php include "lang_and_time_zone.php"; ?>
 
<?php include "tpl/tpl_install_footer.php"; ?>

Данный код мы рассмартивали ранее и нет необходимости повторяться. Функция include подчключает данные из трех файлов по очереди. Вторым по очереди идет ранее созданный в главе 8.4. Файл lang_and_time_zone.php - файл выбора языка и часовой зоны .

Откроем в браузере Файл install.php

Мы видем, что файлы tpl_install_header.php и tpl_install_footer.php создали обертку для нашего lang_and_time_zone.php файла.

Из файла tpl_install_header.php удалим файлы стилей и подключим внешний файл стилей Файл install.css установщика в директории /css/. Наши стиль окна исчезднет, и будет занаво создан в главе 8.8. Файл install.css

tpl_install_header.php

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>Установка UCMS CE</title>
    <!--  Начало стилей установщика, выносим стили в отдельный файл 
          install.css, который находиться в директории css	-->
  <link rel="stylesheet" type="text/css" href="css/install.css"> 
    <!--  Конец стилей установщика	-->
  </head>
  <body> 
    <!--  Начало блока рамки установщика -->
    <div class="block_install">
        <div class="block_window_install">
        <!--  Начало блока названия программы -->
            <div class="block_install_name">
        		Установка UCMS Demo
            </div>
		<!--  Конец блока названия программы -->
		<!--  Начало блока вставки файлов программы -->

← 8.6. Файл module_help.php 8.8. Файл install.css →

creating_installer_directories

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Dec 2025 12:29:58 +0000

8.1. Создание директорий установщика

Введение

Директорию установщика install расположим в директории /library, в которой в дальнейшем будут распологаться файлы установки модулей и шаблонов. Было бы правильнее расположить ее в корне приложения, но т.к. в начале мы указали место для нее в директории «/library», то продолжим по намеченному плану.

Создание директорий

Создадим директории и файлы нашего приложения:

В корневой директории /ucms нашего приложения создадим:

Директорию /library
Файл index.php

В директории library нашего приложения создадим:

Вложенную директорию install

В директории install нашего приложения создадим:

Файл account_settings.php в директории /install
Файл database_options.php в директории /install
Файл installation_progress.php в директории /install
Файл options.php в директории /install
Файл setting.php в директории /install
Файл install.php в директории /install
Файл server_check.php в директории /install
Вложенную директорию /css в директории install
Файл install.css в директории /install/css
Вложенную директорию /js в директории install
Файл install.js в директории /install/css
Вложенную директорию /tpl в директории /install
Файл tpl_install_header.php в директории /install/tpl
Файл tpl_install_footer.php в директории /install/tpl

В дальнейшем в этом руководстве мы научимся создавать директории и файлы с последующим заполнением файлов данными средствами PHP, а пока нас вполне устроит создание файлов вручную, а созданное нами приложение в конечном виде, уже будет иметь все необходимые файлы и директории при распаковке скачанного архива.

← 8. Установщик приложения 8.2. Файл index.php →

creating_project

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 10:42:53 +0000

4.1 Создание проекта

Запишем основные действия пользователя будущего приложения:

Пользователь заходит на главную страницу впервые, программа проверит:
1. если приложение не установленно, то отправит пользователя в панель установки приложеня.
2. если приложение установленно, то приложение проверит регистрацию пользователя.
3. если пользователь не зарегистрирован, перенаправит на регистрацию.
4. если пользователь зарегистрирован, перенаправит на авторизацию.
5. если авторизация не прошла успешно, заблокирует на время этого пользователя.
6. если авторизация прошла успешно, откроет панель администратора.
7. если открыта панель администратора, но не установлена конфигурация (видеохостинг, блог или социальная сеть), то приложение придложит сделать выбор и установить.
8. если открыта панель администратора и установлена конфигурация (видеохостинг), то приложение придложит сделать выбор между закрытой (вход по логину и паролю) или открытой (общедоступной).
  1. если открытая (общедоступная), то можно ли регистрироваться и т.д.. (Видеохостинг описан в руководстве по написанию UCMS Video, что является продолжение данного руководства). А в этом, мы остановимся на выборе конфигурации, окне настройки, установке дополнительных модулей (загрузка файлов, почта, редактор текста, двуфакторная авторизация и т.д.), добавление шаблонов, языков и прочее, а пока…

В наш маленький проект внесем дополнения:

Пользователь заходит на главную страницу index.php впервые, программа проверит:
1. если приложение не установленно (файлы config.ini, version.txt не существуют), то отправит пользователя в панель установки приложеня (файл install.php) в директорию /install.
2. панель установки приложеня (файл install.php) предложит выбрать язык (английский/русский)
3. по умолчанию предложен английский (файл lang_en.php) в дирректории lang установщика
4. при выборе русский (файл lang_ru.php) в дирректории lang файл установщика install.php переключит установщик на русский язык и будет ожидать выбора часового пояса (форма выбора timezone -12, 0, +12)
5. после выбора станет активной кнопка «Продолжить», при нажатии на которую, значения переменных lang_select и timezone_select будут записаны в файл конфигурации config.ini
6. пользователь будет перенаправлен к окну проверки совместимости сервера (файл check_server.php)

Пока остановимся. Откуда названия файлов и директорий (папок)? Назначаем имена файлам сами, чтобы нам проще было понять, например:

config - в переводе с английского конфигурация
install - установка
lang - язык
check_server - проверить сервер
timezone - часовой пояс и т.д.

Таким образом, мы всегда будем понимать, что директория /install - это папка установки, а переменная lang_select - выбор языка, стало быть lang_select_russian - выбор языка русский.

Подумаем еще немного… А где будет распологаться наше приложение? В корне сайте " / " или в директории «/ucms»? Мы не знаем что хочет пользователь, т.е. создаем приложение в директории /ucms без привязки к директории, а за это будет отвечать файл, где будут постоянные данные - константы (стало быть cons.php). Т.к. cons.php и config.ini являются конфигурационными, то целесообразно использовать отдельную директорию /config

Продолжим наш план-проект…

Пользователь заходит в директорию /ucms на главную страницу файл index.php впервые, программа проверит:
1. если приложение не установленно (файлы config.ini, version.txt не существуют), то перенаправит пользователя в панель установки приложеня (файл install.php) в директорию /install.
2. панель установки приложения (файл install.php) так-же проверит наличие файлов config.ini и version.txt
3. если файл config.ini не существует, то перенаправит к файлу выбора языка часовой зоны lang_and_time_zone.php
4. окно выбора языка и часовой зоны (файл lang_and_time_zone.php) предложит выбрать язык (английский/русский) и часовую зону (от -12 до +12) и в конце попросит подтвердить выбор кнопкой «Продолжить», что создасть файл config.ini и запишет в него значения выбора.
5. по умолчанию предложен английский (файл lang_en.php) в дирректории lang установщика
6. при выборе языка - русский (файл lang_ru.php) в дирректории lang файл установщика (файл выбора языка часовой зоны lang_and_time_zone.php) переключит установщик на русский язык и будет ожидать выбора часового пояса (форма выбора timezone -12, 0, +12)
7. после выбора станет активной кнопка «Продолжить», при нажатии на которую, данные lang_select и timezone_select будут записаны в файл конфигурации config.ini в дирректории /config
8. пользователь будет перенаправлен к окну проверки совместимости сервера (файл check_server.php), который запросит наличие файла version.txt
9. если version.txt не существует (т.е. проверка сервера не проводилась), то приложение перейдет к файлу check_server.php и проверит сервер….
10. если version.txt существует (т.е. проверка сервера ранее проводилась), то приложение перейдет к запросу данных для подключения к приложению баз данных (файл db_config.php)

По мере написания проекта мы видим, что мы пишем «логику» работы приложения, на «научном» языке это называется - «алгоритм», и мы уже видим за какие действия отвечает тот или иной файл и где находится. Мы можем это отобразить формой записи алгоритма и это будет более наглядно для понимания.

Карточки

Проще все визиулизировать, написав/нарисовав карточки (соотвествуют отображению на экране), они же файлы и директории и три кружочка: пользователь, зарегистрированный пользователь и администратор. На карточке название: version.txt, db_config.php и т.д. и в карточках пишем заметки: что делает эта карточка и зарисовки экрана пользователя, а на обратной стороне наброски кода, предварительные таблицы массивов и т.д.

Надеемся, что прочитав данную главу стало понятно, откуда берутся названия файлов, директорий, переменных и т.д. (пример: наименование файла этой страницы creating_project.txt в переводе - 4.1 создание проекта) И главное откуда мы знаем, что будет дальше! Потому что у нас есть - план! При этом мы не будем в этом руководстве писать полный проект, а поверхносто будем коментировать, что и для чего мы создаем и что в итоге получим.

← 4. Планирование 5. Структура директорий →

creating_template

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Dec 2025 15:03:15 +0000

8.9. Файл template.php

Шаблонизатор представляет из себя один или более количество шаблонов HTML-кода, испольующий специальные метки типа {TITLE}, {CONTENT}, {MESSAGES} и т.д. Которые в свою очереь будут заменяться данными.Например:

$tpl->set_value('TITLE', "Заголовок");
$tpl->set_value('CONTENT', $content);

Функция set_value просто устанавливает значение

Таким бразом мы разделим PHP-код, контент и HTML-код.

Файл template.php будет являтся главным файлом шаблонизатора нашего приложения.

← 8.6. Файл module_help.php 8.9. Файл install.css →

directory_structure

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 12:35:15 +0000

5. Структура директорий

Расмотрим примерную структуру нашего приложения (названия директорий произвольное, но проще использовать понятные или традиционные, чтобы не запутаться, например: user - в переводе «пользователь», install - «установка», readme - «прочти меня», user_login - «пользователь_авторизация» и т.д.). Ниже приведен предварительной проект директорий нашей будущей CMS.

./ucms/

users

.htaccess

admin

account_admin

admin_setting.php

admin_nav.php

admin.php

user

account_user

user_login.php

user_logout.php

user_signup.php

messages

user_edit.php

user_nav.php

user.php

ghost.php

users.php

content

data

books

images

media

music

media

cont.php

includes

.htaccess

config.ini

cons.php

db.php

demo

mail.php

lang

lang_en.php

lang_ru.php

function.php

search.php

library

install

css

install.css

install.js

tpl

tpl_install_header.php

tpl_install_footer.php

account_settings.php

database_options.php

install.php

installation_progress.php

lang_and_time_zone.php

module_help.php

options.php

server_check.php

setting.php

template

blog

vcms

standart

css

main.css

nav.css

main.js

nav.js

img

fonts

style.ini

tpl_main.php

tpl_footer.php

tpl_header.php

user_template

updata

main.php

404.php

lib.php

.htaccess

.htpasswd

index.php

help.txt

readme.html

license.txt

version.txt

Надеемся, что из вышеприведенной схемы директорий все понятно? Кратко:

.htaccess — это локальный конфигурационный файл веб-сервера Apache, который позволяет управлять настройками веб веб-приложения.
index.php - это стартовая страница.
readme.html - руководство, которое дает пользователям подробное описание проекта
/user - главная папка пользователей
guest - пользователь с правом только просмотра и поиска по сайту контента.
/account_user - папка аккаунта пользователя (пользователь с правом просмотра, загрузки, редактирования и удаления своего контента, поиска контента, написания комментариев, голосования и прочего.
- user_login.php - файл авторизации пользователя
- user_logout.php - файл окончания сеанса авторизации пользователя
- user_signup.php - файл регистрации нового пользователя
- user_edit.php - редактор постов пользователя
- user_nav.php - меню пользователя
/account_admin - папка аккаунта администратора (полные права, включая настройку сайта и регистрацию прав пользователя/удаление пользователей и модерацию сообщений)
- admin_setting.php - файл настроек CMS администратором
- admin_nav.php - расширенное меню пользователя-администратора
/install - папка установки CMS

и т.д… (см. описание в файле readme.html) с создания которого мы и начнем наш проект в Главе 7. Файл readme.txt.

← 4. Планирование 6. Файл help.txt →

help

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 12:47:02 +0000

6. Файл help.txt

Этот файл не будет участвовать в работе приложения, это - вспомогательный файл для упрощения написания кода. Да, мы будем много писать, и в основном это будут комментарии. Создадим в корне нашего приложения файл с именем help.txt

По мере запоминания кода при частом использовании, мы будем удалять записи из этого файла и в конце нашей работы мы его удалим. А в начале нашего пути в нем будут записываться используемые части кода, чтобы мы всегда могли посмотреть как и что пишется, чтобы не тратить время на перелистывание страниц в интернете. Так-же там будут наши заметки, т.к. за один день мы не успеем охватить весь процесс.

Пример файла help.txt

help.txt

!Это файл - подсказка по написанию кода в руководстве по написанию UCMS
-----------------------------------------------------------------------
<!--  Комментарии html -->
// Комментарии в PHP или /* ... */
/* Комментарии CSS */
// Комментарии в JavaScript или /* ... */
/* Комментарии MySQL */
-----------------------------------------------------------------------
<?php
	// Вставка кода PHP в HTML-файл
?>
-----------------------------------------------------------------------
Подключение файлов JavaScript к HTML
<script src="js/main.js"></script>
-----------------------------------------------------------------------
Подключение файлов CSS к HTML
<link rel="stylesheet" href="/style.css">
/////////////////////////Важно!////////////////////////////////////////
в файле login.php переменную password заменили на login_pass
не забыть !!! произвести замену в reg.php
////////////////////////26.04.2025/////////////////////////////////////
закончили на подключении файла стилей CSS в index.php в директории ./ucms/bin/user в Главе 14 руководства UCMS
и т.д.

Казалось бы, этого можно не делать, но поверьте, когда у нас будет много директорий и много файлов, мы начнем путаться, а если нас еще и отвлекут от процесса на недельку, то мы вообще все забудим, а так у нас будет все записано, то нам не прийдется начинать все с начала.

← 5. Структура директорий 6.1. Файл readme.txt →

htaccess

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 17:14:01 +0000

7.4. Файл .htaccess

Введение

.htaccess — это конфигурационный файл веб-сервера Apache, позволяющий управлять работой веб-сервера и настройками сайта с помощью различных параметров (директив) без изменения основного конфигурационного файла веб-сервера.

Проверка корневой директории

Создадим в /ucms новый файл license_test.txt и запишем в него «текст заглушку»

license_test.txt

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in 
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat 
non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

откроем его в браузере

Файл .htaccess

Создадим в главной директории /ucms файл .htaccess

и запретим к просмотру файла license_test.txt, readme.txt и help.txt находящихся в этой же директории, записав следующий код:

.htaccess

# запретим просмотр файлов с расширением .txt следующих файлов
# license_test.txt, readme.txt, help.txt
RewriteEngine On
RewriteRule ^(license_test|readme|help)\.txt$ - [R=403,L,NC]

Обновим страницу браузера

Теперь при обращении к файлу license_test.txt Веб-сервер выводит сообщение о запрете на доступ к этому файлу.

«Некоторые советы и рекомендации по Apache .htaccess»

.htaccess

# Источник интернет
# Source internet
# Сначала протестируйте на локальном хосте
# Test on localhost first

# Переопределить значение по умолчанию index.php
# Ovrride Default index.php
DirectoryIndex home.php
 
# Запретить доступ к некоторым файлам
# Prevent access to some files
< FilesMatch  "^(config.php|readme.html|license.txt|README.md|.git|.htaccess|error_log)">
    Order allow,deny
    Deny from all
    Satisfy All
</FilesMatch>
 
# Изменить заголовки Charset и Language
# Change Charset and Language headers
AddDefaultCharset UTF-8
DefaultLanguage en-US
 
# Установить часовой пояс по умолчанию
# Set default time zone
SetEnv IN Asia/Calcutta
 
# Отключить просмотр каталогов
# Disable directory browsing
Options All -Indexes
 
# Кэшировать такие файлы на 7 дней
# Cache these type of files for 7 days
<IfModule mod_headers.c>
<FilesMatch "\.(jpg|jpeg|png|ico|gif|css|js|eot|otf|tt[cf]|woff|woff2|svg|mp4|webm|ogv)$">
    Header set Cache-Control "max-age=604800, must-revalidate"
    Header unset ETag
    FileETag None
</FilesMatch>
 
# Явно отключить кэширование для скриптов и других динамических файлов
# Explicitly disable caching for scripts and other dynamic files
<FilesMatch ".(pl|php|cgi|spl|scgi|fcgi)$">
Header unset Cache-Control
</FilesMatch>
 
# Сжатие Java-скрипта
# Java script compression
<FilesMatch "\.js$">
RewriteEngine On
RewriteCond %{HTTP:Accept-Encoding} gzip
RewriteCond %{REQUEST_FILENAME}.gz -f
RewriteRule (.*)\.js$ $1\.js.gz [L]
ForceType text/javascript
</FilesMatch>
 
# Java-скрипт - выбор кодировки
# Java script - vary accept encoding
<FilesMatch "\.js\.gz$">
ForceType text/javascript
Header set Content-Encoding gzip
Header set Vary Accept-Encoding
</FilesMatch>
 
# Остановить автоматическое добавление файлов веб-хостингом
# Stop auto append files by webhosting
<FilesMatch "\.(php)$">
php_value auto_append_file none
</FilesMatch>
 
# Перенаправление URL без www на URL с www -
# Redirecting non www URL to www URL -
RewriteEngine On
RewriteCond %{HTTP_HOST} ^example\.com$
RewriteRule (.*) http://www.example.com/$1 [R=301,L]
 
# Пользовательские страницы ошибок
# Custom error pages
ErrorDocument 400 /error404.php
ErrorDocument 401 /error401.php
ErrorDocument 403 /error403.php
ErrorDocument 404 /error404.php
ErrorDocument 500 /error500.php
 
# Отключить подпись сервера (версия Apache)
# Disable the server signature (apache version)
ServerSignature Off
 
# Максимальный размер загрузки
# Max upload size
php_value upload_max_filesize 5M
 
# Включить сжатие на локальном хосте
# Enable compression on localhost
<IfModule mod_deflate.c>
  SetOutputFilter DEFLATE
</IfModule>
 
# Исправить плохой метатег x-ua
# Fix bad x-ua meta tag
<FilesMatch "\.(htm|html|php)$">
    <IfModule mod_headers.c>
        BrowserMatch MSIE ie
        Header set X-UA-Compatible "IE=Edge,chrome=1" env=ie
    </IfModule>
</FilesMatch>
 
# Обслуживать файлы шрифтов
# Serve font files
<FilesMatch ".(eot|ttf|otf|woff)">
	Header set Access-Control-Allow-Origin "*"
</FilesMatch>
 
#Включить gzip с помощью mod_gzip
#Enable gzip with mod_gzip
<ifModule mod_gzip.c>
mod_gzip_on Yes
mod_gzip_dechunk Yes
mod_gzip_item_include file .(html?|txt|css|js|php|pl)$
mod_gzip_item_include handler ^cgi-script$
mod_gzip_item_include mime ^text/.*
mod_gzip_item_include mime ^application/x-javascript.*
mod_gzip_item_exclude mime ^image/.*
mod_gzip_item_exclude rspheader ^Content-Encoding:.*gzip.*
</ifModule>
 
# Защитить каталог, отключив выполнение скрипта
# Secure directory by disabling script execution
AddHandler cgi-script .php .pl .py .jsp .asp .htm .shtml .sh .cgi
Options -ExecCGI
 
# Тип MIME для веб-шрифтов
# Mime type for web fonts
<IfModule mod_mime.c>
    AddType application/vnd.ms-fontobject   eot
    AddType application/x-font-ttf          ttf ttc
    AddType font/opentype                   otf
    AddType application/x-font-woff         woff woff2
    AddType image/svg+xml                   svg svgz
    AddEncoding gzip                        svgz
</IfModule>
 
# Запретить доступ к папке .git и вернуть 404
# Prevent .git folder access and return 404
RewriteRule ^.*\.git.* - [R=404]
 
# Скрыть php через htaccess, удалит .php из URL-адресов

<IfModule mod_rewrite.c>
# Apache rewrite_module must be on
RewriteEngine on
RewriteRule ^([^.?]+)$ %{REQUEST_URI}.php [NC,L]
 
# Redirect with moved status
RewriteRule ^([^.?]+)$ %{REQUEST_URI}.php [R=302,NC,L]
 
# Return 404 if original request is file.php
RewriteCond %{THE_REQUEST} "^[^ ]* .*?\.php[? ].*$"
RewriteRule .* - [L,R=404]
</IfModule>
 
# Запретить выполнение PHP-скриптов из папки загрузок
# File location example: /uploads/.htaccess
<FilesMatch "\.(?i:php)$">
  <IfModule !mod_authz_core.c>
    Order allow,deny
    Deny from all
  </IfModule>
  <IfModule mod_authz_core.c>
    Require all denied
  </IfModule>
</FilesMatch>

← 7.3. Файл function.php 8. Установщик приложения →

index

anonymous@undisclosed.example.com (Anonymous) — Mon, 12 May 2025 18:57:23 +0000

8.2. Файл index.php

Введение

Данный файл является Индексным файлом — это файл главной страницы директории на сайте, то есть тот файл, который загружается, когда посетитель обращается напрямую к директории. В нашем приложении Файл index.php - это точка входа.

Логика index_test.php

ЕСЛИ ядро приложение не установленно (т.е. отсутствуют файлы version.txt и config.ini в директории /includes), то приложение выведит в окне /library/install к файлу install.php
ИНАЧЕ проверит переменную $default_site в файле config.ini
ЕСЛИ переменная $default_site = пустое значение, то приложение выведит в окне индексный файл, первой из установленных конфигураций
ИНАЧЕ получив значение переменной $default_site из файла default_site перенаправит к install.php - индексный файл установленной конфигурации, указанный пользователем.

Файл index_test.php

Создадим Файл index_test.php в /ucms с кодом:

index_test.php

<!-- test/index_test.php -->
 
<?php
/* подключим файл с константами, для апределения корневой директории приложения */
require_once __DIR__ . "../../includes/cons.php";
 
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.ini' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
	/* Если config.config.ini существует */
        if (file_exists($file_config)) {
	/* выводим запись о существовании */
			echo "Файл $file_config существует". "<br/>";
	/* Иначе выводим запись о существовании*/
		} else {
			echo "Файл $file_config не существует". "<br/>";
		}
 
// Создание и вызов параметров из .ini файла
////////////////////////////////////////////
/* задаем переменной  значение $config 
* parse_ini_file - обрабатывает конфигурационный файл
* ../../includes/config.ini - путь к config.ini
* ,true); - обрабатываем с секциями (зпголовками)
*/
$config_defaul_site = parse_ini_file(FOLDER . "/includes/config.ini",true);
// Проверьте, успешно ли прочитан ini-файл.
// переменная $config не ровно ЛОЖЬ
if ($config_defaul_site !== false) {
    // Доступ к индивидуальным настройкам
 
	$default_site = $config_defaul_site['default_site']['default_site'];
      echo "Конфигурация по умолчанию: " . $default_site . "<br/>";
} else {
    echo "Ошибка чтения INI-файла.";	
}
//exit;		
/* зададим переменным файлы и директории */
$file_config = FOLDER . '/includes/config.ini';
$file_version = FOLDER . '/version.txt';
 
$bcw_site = FOLDER . '/bcw';
$blog_site = FOLDER . '/blog';
$video_site = FOLDER . '/video';
$sns_site = FOLDER . '/sns';
 
/* Если переменные $file_config и file_exists существуют,
то проверим определение переменной конфигурации $default_site
по умолчанию в файле config.ini */
if (file_exists($file_config) && file_exists($file_version)) {
	/* Если переменная $default_site равно "пустое место" */
	if ($default_site == ""){
    /* Проверим, что конфигурация установлена в директории /bcw */
		if (file_exists($bcw_site)) {
		/* Если директория /bcw существует, перенаправим туда и конец скрипта*/
		header("Location: ../bcw/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /blog */
		elseif (file_exists($blog_site)) {
		/* Если директория /blog существует, перенаправим туда и конец скрипта*/
		header("Location: ../blog/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /video */
		elseif (file_exists($video_site)) {
		/* Если директория /video существует, перенаправим туда и конец скрипта*/
		header("Location: ../video/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /sns */
		elseif (file_exists($sns_site)) {
		/* Если директория /sns существует, перенаправим туда и конец скрипта*/
		header("Location: ../sns/");
		exit;
		}
	}
	else { 
		/* Если переменная $default_site равно "выбор в файле конфигуратора" 
		перенаправить на страницу, указанную в config.ini*/
		header("Location: ../" . "$default_site" . "/");
		}
	} 
/* Если Переменные $file_config или file_exists не существуют,
то перенаправим на страницу установщика install.php */
else { 
    header("Location: ../library/install/install.php");
}
?>

Обратите внимание на следующую часть кода:

}
//exit;		
/* зададим переменным файлы и директории */

exit; необходима только лишь для остановки кода, чтобы увидеть проверку работы кода, если

в config.ini выбрана конфигурация по умолчанию.

Проверка существований директорий

Создаем в /ucms/include пустой файл config.ini и запускаем в браузере файл /ucms/test/index_test.php

config.ini существует и он пустой, тогда:

Проверим работу страницы index_test.php в веб - браузере, создав поочередно в директории /ucms вложенные директории: bcw, blog, video, и sns с вложенными файлами index.php внутри которых запишем имя директории. К примеру: создадим директорию sns с вложенным файлом index.php и записываем

index.php

<? php
это файл sns
?>

А при добавленной директории blog переадресация на /ucms/blog/ т.к. он раньше назначен у нас в проверке

И так поступаем с каждой директорией, проверяя (обновляя страница) логику поиска и открытия первой по алфавиту директории. Ну и при создании всех 4х директорий, мы получим первую по списку при запуске index_test.php

index_test_2.php

Создадим в директории /test файл index_test_2.php который будет нам создавать файл с записью конфигурации. К примеру: video

index_test_2.php

<!-- test/index_test_2.php -->
 
<?php
/* подключим файл с константами, для апределения корневой директории приложения */
require_once __DIR__ . "../../includes/cons.php";
 
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.php' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
	/* Если config.config.ini существует */
        if (file_exists($file_config)) {
	/* выводим запись о существовании */
			echo "Файл $file_config существует". "<br/>";
	/* Иначе выводим запись о существовании*/
		} else {
			echo "Файл $file_config не существует". "<br/>";
		}
$config_defaul_site = parse_ini_file(FOLDER . "/includes/config.ini",true);
// Проверьте, успешно ли прочитан ini-файл.
// переменная $config не ровно ЛОЖЬ
if ($config_defaul_site !== false) {
    // Доступ к индивидуальным настройкам
 
	$default_site = $config_defaul_site['default_site']['default_site'];
      echo "Конфигурация по умолчанию: " . $default_site . "<br/>";
} else {
    echo "Ошибка чтения INI-файла.";	
}
// Создаем массив пар
$databaseSections = [
    'default_site' => 'video',
];
 
// Записать конфигурацию в раздел «'default_site'»
$success = write_to_ini($databaseSections, 'default_site', '../includes/config.ini');
 
// Проверим, успешно ли выполнена запись в файл.
if ($success) {
    echo "Запись в файл прошла успешно!";
} else {
    echo "Ошибка записи INI-файла.";
}
// Функция записи настроек в определенный раздел INI-файла
function write_to_ini($config, $section, $file) {
    $content = "\n; Application Configuration Settings\n\n[$section]\n; Configuration\n";
 
    foreach ($config as $key => $value) {
        $content .= "$key = $value\n";
    }
 
    // Добавить содержимое в файл
    return file_put_contents($file, $content, FILE_APPEND) !== false;
}
?>

Примечание:
Ранее config.ini создавали мы, значит и владелец файла на запись и чтение тоже мы, а нам необходимо передать права нашему приложению. Заодно проверим код записи в файл.

Удалим созданный нами файл config.ini и запустим в браузере файл index_test_2.php

т.к. мы удалили файл config.ini мы получили сообщение:

Файл /volume1/web/ucms/includes/config.ini не существует - файла действительно нет
Ошибка чтения INI-файла. - прочесть файл приложение не смогло
Запись в файл прошла успешно! - был создан новый config.ini с записью default_site = video

Запустим в браузере страницу файл index_test.php

Так-же проверим работу логики при пустом значении переменной $default_site в файле config.ini в директории ucms/includes

default_site =

Приложение перешло на первую по списку директорию.

Аналогично, для определенной переменной $default_site

default_site = blog

Логика index.php

ЕСЛИ ядро приложение не установленно (т.е. отсутствуют файлы version.php и config.ini в директории /includes), то приложение перенаправит в /library/install к файлу install.php
ИНАЧЕ проверит переменную $default_site в файле config.ini
ЕСЛИ переменная $default_site = пустое значение, то приложение перенаправит на индексный файл, первой из установленных конфигураций
ИНАЧЕ получив значение переменной $default_site из файла config.ini перенаправит к index.php установленной конфигурации, указанной пользователем.

По замыслу пользователь может установит несколько приложений и указать приложение по умолчанию в config.ini, тогда в корневой директории будет работать указанное приложение, а к остальным будет доступ через ссылку в коде программы на директория другой конфигурации. К примеру:

Пользователь установил 2е конфигурации blog и video и выбрал основной конфигурацию blog, тогда в окне index.php будет работать конфигурация blog, а конфигурацию video будет доступна через указание директории /video/video.php

Файл index.php

Главным отличием файла index.php от index_test.php станут:

корректировка директорий файлов
вынос «логики» в основной файл функций function.php с созданием функции check_start()
вывод конфигурации в «окне» файла index.php вместо вывода в отдельной директории

Создадим в директории /ucms файл входа в приложение index.php

index.php

<?php
/* index.php */
/* подключим файл с константами, для определения корневой 
 *директории приложении и файлов конфигурации и функций */
include './includes/cons.php';
include FOLDER . '/includes/function.php';
/* запустим функцию проверки первого входа в приложение */
check_start();
?>

Создадим в директории /includes файл function.php и запишем в него нашу первую функцию check_start();

function.php

<?php 
/* Функция проверки установки ядра приложения и установленной конфигурации */
function check_start() {
	/* Присваиваем переменной $file_config значение константы FOLDER 
	(а это директория ucms, записанная в файле cons.php)и добовляем 
	'/includes/config.php' - директорию includes и искомый файл config.ini */
    $file_config = FOLDER . '/includes/config.ini';
 
// Создание и вызов параметров из .ini файла
////////////////////////////////////////////
/* задаем переменной  значение $config 
* parse_ini_file - обрабатывает конфигурационный файл
* /includes/config.ini - путь к config.ini
* ,true); - обрабатываем с секциями (зпголовками)
*/
$config_defaul_site = parse_ini_file(FOLDER . "/includes/config.ini",true);
// Присвоим переменной $default_site значение из ini-файл.
$default_site = $config_defaul_site['default_site']['default_site'];
/* зададим переменным файлы и директории */
$file_config = FOLDER . '/includes/config.ini';
$file_version = FOLDER . '/version.txt';
 
$bcw_site = FOLDER . '/bcw';
$blog_site = FOLDER . '/blog';
$video_site = FOLDER . '/video';
$sns_site = FOLDER . '/sns';
 
/* Если переменные $file_config и file_exists существуют,
то проверим определение переменной конфигурации $default_site
по умолчанию в файле config.php */
if (file_exists($file_config) && file_exists($file_version)) {
	/* Если переменная $default_site равно "пустое место" */
	if ($default_site  == ''){
    /* Проверим, что конфигурация установлена в директории /bcw */
		if (file_exists($bcw_site)) {
		/* Если директория /bcw существует, перенаправим туда и конец скрипта*/
		header("Location: ./bcw/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /blog */
		elseif (file_exists($blog_site)) {
		/* Если директория /blog существует, перенаправим туда и конец скрипта*/
		header("Location: ./blog/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /video */
		elseif (file_exists($video_site)) {
		/* Если директория /video существует, перенаправим туда и конец скрипта*/
		header("Location: ./video/");
		exit;
		}
		/* Проверим, что конфигурация установлена в директории /sns */
		elseif (file_exists($sns_site)) {
		/* Если директория /sns существует, перенаправим туда и конец скрипта*/
		header("Location: ./sns/");
		exit;
		}
	}
	else { 
		/* Если переменная $default_site равно "выбор в файле конфигуратора" 
		перенаправить на страницу, указанную в config.php*/
		header("Location: ./" . "$default_site" . "/");
		exit;
		}
	} 
/* Если Переменные $file_config или file_exists не существуют,
то перенаправим на страницу установщика install.php */
else { 
    header("Location: ./library/install/install.php");
	exit;
	}
}
?>

Откроем в браузере наш файл /ucms/includes/config.ini

Как вы уже догадались мы закроем файл config.ini файлом .htaccess

.htaccess

# запретим просмотр файлов с расширением .ini следующих файлов
# (задается правило для перенаправления)
# config.ini
RewriteEngine On
RewriteRule ^(config)\.ini$ - [R=403,L,NC]

← 8.1. Создание директорий установщика 8.3. Файл lang.php →

introduction

anonymous@undisclosed.example.com (Anonymous) — Mon, 12 May 2025 15:33:29 +0000

1. Введение в UCMS Demo

UCMS - это универсальная систе́ма управле́ния содержи́мым (англ. universal content management system, CMS, система управления контентом). Данное руководство по написанию UCMS Demo представляет из себя поэтапный план создания полноценного приложения от начала планирования до тестирования и состоит из нескольких частей:

UCMS Kernel - создание ядра приложения и модулей, а так-же шаблонов.
UCMS Bcw - создание подключаемого модуля сайта-визитки (англ. BCW, от business card website)
UCMS Blog - создание подключаемого модуля блога (англ. blog, от web log)
UCMS Video - создание подключаемого модуля видеохостинга (лат. video и англ. hosting)
UCMS Sns - создание подключаемого модуля социа́льная сеть (англ. SNS от social networking service)

Каждой части будет соответствовать отдельное руководство. Для создания собственного приложения будет достаточно ознакомиться с частью 1. UCMS Kernel и любой другой частью на усмотрение пользователя.

Так же проект UCMS будет доступен в трех исполнениях:

UCMS Demo - рабочая учебная версия
UCMS CE - для личного использования
UCMS EE - для коммерческого использования

Все версии будут иметь цифровое обозначение релиза по мере выхода новой версии (UCMS Demo ver.1.0.0 - первый релиз). Разработка UCMS CE и UCMS EE в руководстве рассматриваться не будет, но они будут доступны для загрузки по мере написания данного руководства.

Использование руководства

В руководстве UCMS Demo вы не увидите привычных и банальных «Hello Word» и полного курса HTML, CSS и т.д. При этом предпологается, что читатель лишь поверхностно об этом слышал, но не изучал. Читатель познакомиться с основными используемыми для этого проекта видами языков и кода через комментарии и создание тестовых страниц.

Например:

index.html

// Пример html кода формы
/*
* при нажатии на кнопку, action="install.php" перенаправит пользователя
* на страницу install.php
*/
<form action="install.php" method="post">
тут пропишем кнопку...
</form>

<form - открывающий тег формы
form action=«install.php» - указывает обработчик, к которому обращаются данные формы при их отправке на сервер.
method=«post» - в отличие от метода GET, который используется для получения данных, POST служит для отправки данных на сервер.
</form> - закрывающий тег формы

По мере изучения руководства повторяющиеся комментарии второстепенного кода будут опускаться, чтобы читатель начал привыкать самостоятельно читать код. При этом главные части кода будут по прежнему комментироваться.

Так же в блоках голубого цвета будут отображаться Примечания

и в красных текст, требующий особого Внимания

Внимание:
Данный код приложения, удалит созданную ранее директорию /tеmp.

Пример вывода работы кода в веб - браузере будет дополняться снимками с экрана рабочей станции.

На снимках в строке браузера указанно точное месторасположения файла в директории.

Окно примеров кода

В окне примера кода программы, можно загрузить файл целиком:

Копировать код в буфер обмена:

Получить справку по функциям с официальной страницы https://www.php.net/

Или по HTML со страницы https://johndecember.com

В некоторых главах будет приводиться пример достижения результата разными способами:

config_test_1.php с перечислением данных в коде странице.
config_test_2.php с выборкой данных из массива, находящегося в другом файле.

← Оглавление 2. Рабочая станция →

license

anonymous@undisclosed.example.com (Anonymous) — Thu, 08 May 2025 19:11:45 +0000

6.2. Файл license.txt

← 6.1. Файл readme.txt 7.0. Файл version.php →

planning

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 09:58:52 +0000

4. Проектирование

Эта глава посвящена тому, что везде и во всем должен быть порядок. Так и в рабочем столе и на кухне и тем более в созданном для конечного пользователя приложении. А если не будет порядка, то и при создании мы получим «хаос!» и неразбериху, которые не позволят нам закончить приложение:

написали несколько страниц кода и поняли, что упустили в середине какой-то функционал…
создали страницу с логикой и страница долго грузится…
и так далее…

Все это и не только, станет большим разочарованием и в большенстве заставит нас отложить разработку, а потом и вообще забросить проект.

Мы должны точно знать, что будет находиться между начальной и конечной точкой создаваемого приложения. То-есть:

index.php - начальная точка входа в приложение.
«что-то просходит», к примеру подключается база данных, подключаются стили проекта, формируются таблицы, окрывается форма регистрации и т.д.
admin_panel.php - конечная точка приложения.

И вот в этом «что-то просходит» будет хаос и путаница и разочарование от написания проекта, если не составить заранее план. Нам неоходимо прописать предполагаемый план план взаимодействия приложения и пользователя, например:

Пользователь заходит на главную страницу впервые, программа проверит:
1. если приложение не установленно, то отправит пользователя в панель установки приложеня.
2. если приложение установленно, то приложение проверит регистрацию пользователя.
3. если пользователь не зарегистрирован, перенаправит на регистрацию.
4. если пользователь зарегистрирован, перенаправит на авторизацию.
5. если авторизация не прошла успешно, заблокирует на время этого пользователя.
6. если авторизация прошла успешно, откроет панель администратора.

Пока вроде бы легко и просто, но посмотрим на пункт 1.

если приложение не установленно, то пользователь перенаправляется в панель установки приложеня, а это страница выбора языка и часовой зоны и продолжаем…
- если пользователь не выбрал язык, то
  1. приложение по умолчанию создаст файл конфигурации и запишет в него язык браузера или первый язык в списке приложения
- если пользователь не выбрал часовую зону, то
  1. приложение определит время сервера и запишет его в файл конфигурации…

Легко? Вроде бы легко, но мы уже не учли, что после выбора языка приложение должно переключить нашу страницу в выбранный язык, а какие языки у приложения будут? И пользователю после выбора нужно подтвердить кнопкой «Продолжить», а иначе приложение, установит язик по умолчанию, не дождавшись выбора пользователя…

Лугко? Вроды бы «ДА», но как-то не то, что мы ожидали и хочется пропустить эту главу, но увы, если мы напишем приложение, согласно данной инструкции, то получим приложение, которое уже кто-то написал для учебной цели этой инструкции, и уже есть готовая версия этого приложения. Вы сможите загрузить, как демонстрационную, так и рабочую версию для некоммерческого использования. Прочитав руководство вы сможите модифицировать код под себя и т.д., это позволяет лицензия. Но если вы решите написать свое, то без проекта вам не обойтись, а он в свою очередь облегчит вам работу по написаю кода. Готовы потрать время на проект? Если «Да», продолжаем:

← 3. Программное обеспечение 4.1 Создание проекта →

readme

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 12:55:07 +0000

6.1. Файл readme.txt

Этот файл не участвует в работе приложения, это - вспомогательный файл руководства для упрощения понимания работы приложения. Да, мы будем много писать, и в этом файле мы будем описывать что за файлы у нас на сервере, зачем они и что за функции выполняют. Создадим в корне нашего приложения файл с именем readme.txt

По мере создания папок и файлов приложения, мы будем добовлять записи в этот файл и в конце нашей работы мы получим рабочий файл руковдства. А в начале нашего пути в нем будет записан текст наших, в будущем созданных директорий.

Пример файла readme.txt

readme.txt

//////////////////////////////////////// ДИРЕКТОРИИ ////////////////////////////////////////////
  * ./ucms/ - главная директория (папка) приложения
  * users - главная папка пользователей
    * admin - главная директория администратора приложения
    * account_admin - папка аккаунта администратора (полные права, включая настройку сайта и регистрацию прав пользователя/удаление пользователей и модерацию сообщений)
    * admin_setting.php - файл настроек CMS администратором
    * admin_nav.php - расширенное меню пользователя-администратора
	* admin.php - файл главной страницы администратора приложения
  * guest - пользователь с правом только просмотра и поиска по сайту контента.
  * account_user - папка аккаунта пользователя (пользователь с правом просмотра, загрузки, редактирования и удаления своего контента, поиска контента, написания комментариев, голосования и прочего.
    * user_login.php - файл авторизации пользователя
    * user_logout.php - файл окончания сеанса авторизации пользователя
    * user_signup.php - файл регистрации нового пользователя
    * user_edit.php - редактор постов пользователя
    * user_nav.php - меню пользователя	
  * install - папка установки CMS
  * .htaccess — это локальный конфигурационный файл веб-сервера Apache, который позволяет управлять настройками сайта.
  * index.php - это стартовая страница.
  * readme.html - руководство, которое дает пользователям подробное описание проекта
 
//////////////////////////////////////// ФУНЦИИ ////////////////////////////////////////////
и т.д.

более подробно смотрите в файле readme.txt

← 6. Файл help.txt 7.0. Файл version.php →

software

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 09:42:33 +0000

3. Программное обеспечение

За исключением операционной системы Windows 11 Pro и диспетчера виртуализации Hyper-V на рабочей станции, а равно операционной системы DSM 7.2.2 на Synology NAS DS420+, мы постараемся использовать бесплатное (свободно - распростроняемое) программное обеспечение. И причина кроется в том, что мы всеми доступными способами поддерживаем направление «Free software» и стремимся к увеличению «Свободного программного обеспечениея», пользователи которого имеют права («свободы») на его неограниченную установку, запуск, свободное использование, изучение, распространение и изменение (совершенствование), а также распространение копий и результатов изменения.

FSF

“Фонд свободного программного обеспечения (ФСПО) — некоммерческая организация, задачей которой является содействие свободе пользователей компьютеров по всему миру. Мы защищаем права всех пользователей программ”. Присоединяйтесь к FSF

GNU

GNU — операционная система типа Unix, программы которой свободны — они уважают вашу свободу. Операционная система GNU состоит из пакетов GNU (программ, выпускаемых собственно проектом GNU), а также свободных программ, выпускаемых другими лицами. Разработка GNU сделала возможной пользование компьютером без программ, которые растоптали бы вашу свободу.

Мы рекомендуем версии GNU для установки (точнее, дистрибутивы GNU/Linux), полностью состоящие из свободных программ.

GNU General Public License

Универсальная общедоступная лицензия GNU или Открытое лицензионное соглашение GNU — лицензия на свободное программное обеспечение, созданная в рамках проекта GNU в 1988 г., по которой автор передаёт программное обеспечение в общественную собственность. Её также сокращённо называют GNU GPL или даже просто GPL.

Именно GNU GENERAL PUBLIC LICENSE Version 3 лежит в основе Лицензии свободной документации GNU (FDL) данного руководства и Лицензии Attribution-ShareAlike 4.0 International создаваеммого нами продукта UCMS.

Мы с гордостю размещаем официальный логотип GPL от Хосе Обэд, чтобы продемонстрировать всем, что мы заинтересованны в том, что программое обеспечение должно быть! общедоступно ! всем слоям населения в любой точке мира. Будет очень здорово, если данное руководство поможет Вам освоиться в мире программирования и по мере написания кода в дальнейшем, вы не будите забывать о том, что знания, которые вы получили, были доступны для Вас «бесплатно!» И возможно когда-то, вы поможите сообществу GNU, выпустив ряд руководств или приложений под лицензией GNU General Public License.

Мы с радостью сообщаем, что внося вклад в продвижение бесплатного программного обеспечения, нам удалось запустить и поддерживать зеркало бестлатно распростроняемого и открытого ПО.

А пока хотим выразить огромную блогодарность всем заинтересованным людям, поддерживающим данное направление!

Отдельная благодарность †Валентине и †Николаю, вдохновившим нас на написание данного руководства!

2. Рабочая станция 4. Планирование →

ucms_table_of_contents

anonymous@undisclosed.example.com (Anonymous) — Sun, 28 Dec 2025 14:18:54 +0000

worldwide open-source software

ucms

anonymous@undisclosed.example.com (Anonymous) — Sat, 26 Apr 2025 10:20:15 +0000

Создание собственной CMS

В этой статье мы рассмотрим создание собственной cms с инсталятором, регистрацией пользователей и шаблонами сайта. При этом это будет общая cms-шаблон, для которой будет возможность создавать темы и плагины. Поэтому нам понадобиться время и все наше усердие. Предпалогается, что модулями выступят: сайт блога, видеохостинг, букхостинг и небольшая социальная сеть с возможностью личных сообщений.
А начнем мы с самого простого, с видеохостинга, так как блог- это совсем просто. И что нам понадобиться? Правильно сервер с установленным ПО.
В моем случае:

Apache HTTP Server
база данных MariaDB

Позже сдетаем тоже самое с файловой базой для домашнего использования. Основное рукописание в Notepad++ на:

Подготовка к работе

Планирование

На нашем вебсервере создаем директорию с понятным названием, к примеру… и так уже обозначенно в нашем проекте «ucms» - «Universal Content management system» (Универсальная Система Управления Контентом), а в ней файл с расширение .txt и именем readme Этот файл не будет участвовать в работе приложения, в этом файле мы будем писать подробное руководство для пользователя проекта. Да, мы будем много писать, и в основном это будут комментарии. Поэтому создаем еще один файл с именем help.txt этот файл в конце нашей работы мы удалим, в нем будут записываться используемые части кода, чтобы вы всегда могли посмотреть как и что пишется, чтобы не тратить время на перелистывание страниц в интернете. Так-же там будут наши заметки, т.к. за один день мы не успеем охватить весь процесс.

← Оглавление Создание установщика CMS →

← Оглавление Файл readme.txt →

version

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 12:58:13 +0000

7.0. Файл version.php

Файл предназначен, для регистрации ядром приложения данных установленного приложения, таких как версия ядра, версии модулей, установленных конфигураций, а так-же настройке сервера. Необходим для обновления ядра, модулей, а так-те при обращении в тех. поддержку.

Создается файлом при установке ядра приложения:

server_check.php

Редактируется файлами:

update.php
install_module.php
install_site.php

← 6.2. Файл license.txt 7.1. Файл cons.php →

workstation

anonymous@undisclosed.example.com (Anonymous) — Sun, 11 May 2025 09:36:53 +0000

2. Рабочая станция

Ниже приведены параметры рабочей станции и сервера, а так же ПО, используемые для работы над написанием руководства и приложения.

Windows 11 Pro с установленным диспетчером Hyper-V
Google Chrome — браузер, разрабатываемый на основе свободного браузера Chromium и движка Blink.
Mozilla Firefox - свободный браузер на движке Gecko.
Putty - клиентская программа для работы с сетевым протоколом SSH, SFTP и генерации цифровых SSH-ключей, которая является свободным приложением с открытым исходным кодом и распространяется под Open Source лицензией MIT.
Notepad++ - бесплатный текстовой редактор исходного кода. Работая в среде MS Windows, его использование регулируется GNU General Public License.

Тестирование будет производиться дополнительно на Wamp Server и диспетчере виртуальных машин Hyper-V. Веб - браузеры для тестирования Google Chrome и Firefox.

В качестве сервера при написании руководства, а равно приложения нами будет использоваться HTTP Server Apache/2.4.58 (Unix) на Synology NAS c PHP: 8.2.21 и MariaDB 10, но можно для простоты использовать локальный сервер, например Denwer или Wamp

Apache HTTP Server - свободно распростроняемый веб-сервер с открытым исходным кодом.
MariaDB - система управления базами данных MySQL, разрабатываемое сообществом под лицензией GNU GPL.
DokuWiki - вики-движок, который может быть использован для создания любой документации, распространяемый на условиях GNU General Public License версии 2. Автор проекта DokuWiki — Andreas Gohr.

← 1. Введение 3. Программное обеспечение →

worldwide open-source software - software:development:demo:cms:ucms

appendix_a

Public Domain Mark 1.0 Universal

PDM 1.0 КРАТКОЕ ОПИСАНИЕ

Нет авторских прав

Другая информация

appendix_c

Выбор часового пояса

application_installer

8. Установщик приложения

checking_web_server

8.1. Создание директорий установщика

creating_file_config

7.2. Файл config.ini

Введение

Запись данных в **config.ini**

Чтение данных из **config.ini**

creating_file_cons

7.1. Файл cons.php

Введение

cons.php

creating_file_function

7.3. Файл function.php

Введение

Файл function_test.php

Файл function.php

creating_file_install_css

8.8. Файл install.css

creating_file_lang_and_time_zone

8.4. Файл lang_and_time_zone.php

Формы

Переключатель

Выпадающий список

Кнопка

Логика формы

Файл test_3

8.4. Файл lang_and_time_zone.php

creating_file_lang

8.3. Файл lang.php

Файлы перевода

Файл lang_test.php

Файл lang.php

creating_file_module_help

8.6. Файл module_help.php

Создание

creating_file_server_check

8.5. Файл server_check.php

Введение

Подготовка

Запросы

Блок логики версии PHP

Блок логики проверки модулей PHP

Блок логики проверки прав доступа

Блок логики переменной $install_error

Файл test_4.php

Файл server_check.php

creating_install

8.7. Файл install.php

Файл test_5.php

tpl дирректория и шаблоны

Файл install.php

creating_installer_directories

8.1. Создание директорий установщика

Введение

Создание директорий

creating_project

4.1 Создание проекта

Карточки

creating_template

8.9. Файл template.php

directory_structure

5. Структура директорий

help

6. Файл help.txt

htaccess

7.4. Файл .htaccess

Введение

Проверка корневой директории

Файл .htaccess

index

Запись данных в config.ini

Чтение данных из config.ini