Настройка CS-Cart¶
Файл с настройками для разработки¶
В CS-Cart можно создать файл local_conf.php и вносить изменения в него, а не в стандартный config.local.php.
Значения настроек из local_conf.php имеют больший приоритет по сравнению с config.local.php.
Чтобы настроить CS-Cart для разработки, выполните следующие шаги:
Создайте файл local_conf.php в корневой директории вашей установки CS-Cart.
Откройте файл local_conf.php и добавьте туда следующий код:
Как работают настройки¶
Ограничения по IP¶
При работе с “живым” магазином можно сделать так, чтобы настройки из файла применялись только для определённого IP-адреса. Так только вы сможете увидеть сообщения об ошибках и дебаг-панель.
Ограничения по IP задаются в следующей части кода:
Если вы работаете с “живым” магазином, замените 127.0.0.1 на ваш IP-адрес. Если магазин ещё не доступен покупателям, можете убрать это условие.
Дебаг-панель¶
Использование параметра debug также сделает дебаггер доступным на витрине в текущей сессии браузера.
Чтобы дебаггер всегда был включен в панели администратора и на витрине, раскомментируйте следующую строку в local_conf.php:
Не используйте define(‘DEBUG_MODE’, true); на “живом” магазине, чтобы пользователи случайно не получили доступ к данным, которые для них не предназначены.
Режим разработки¶
При написании кода PHP, шаблона SMARTY или SQL-запроса можно допустить ошибку. Обычно ошибки PHP или SMARTY приводят к тому, что отображается пустая страница. Если же произошла ошибка базы данных, вызванная неправильным SQL-запросом, вы увидите следующее сообщение: SERVICE UNAVAILABLE. Sorry, service is temporarily unavailable.
Чтобы увидеть само сообщение об ошибке, можно воспользоваться режимом разработчика. Этот режим включается в файле local_conf.php следующей строкой:
Теперь в случае ошибки вы увидите сообщение об ошибке, а также путь к файлу, который эту ошибку вызвал.
У режима разработчика есть ещё одна функция, полезная для разработчиков модулей.
CS-Cart хранит файлы CSS и TPL от установленных модулей в папке design/themes. Обычно CS-Cart удаляет эти файлы при удалении модуля. Если модуль снова устанавливается, то эти файлы берутся из папки var/themes_repository.
Поэтому можно потерять свои наработки, если вы сначала отредактируете файлы .css и .tpl у модуля в папке design/themes, а затем удалите модуль в панели администратора.
Но если вы включите режим разработчика, то файлы модуля в папке design/themes не будут удалены при удалении модуля.
Файлы .css и .tpl из папки var/themes_repository всё равно перезапишут файлы из design/themes при следующей установке модуля.
Отображение ошибок SMARTY и PHP на экране¶
Иногда нужно переопределить настройки PHP или веб-сервера, чтобы сообщения об ошибках отображались. Поэтому мы добавили в local_conf.php следующий код:
Отключение кэша блоков¶
CS-Cart кэширует блоки, чтобы ускорить загрузку страниц. Но при разработке удобнее, если сразу видно все изменения. Поэтому вы можете отключить кэширование блоков, добавив в local_conf.php следующий код:
Настройки базы данных и хоста¶
Вы можете заменить реквизиты БД и HTTP-хоста. Это полезно, если вы работаете на локальной копии уже существующего магазина и не хотите ничего менять в файле config.local.php.
Раскомментируйте в local_conf.php следующие строки и укажите свои значения:
Хранилище для кэша и данных сессии¶
С помощью local_conf.php вы можете изменить хранилище данных для кэша. Раскомментируйте следующий код и задайте нужное значение:
Возможные варианты: file, sqlite, database, redis, xcache и apc. Для работы sqlite, apc и xcache нужно установить на сервере соответствующие модули PHP.
Также вы можете изменить хранилище данных для сессий. Раскомментируйте следующий код и задайте нужное значение:
Возможные варианты: database и redis.
Системные требования¶
Серверное окружение¶
CS-Cart разработан с учётом большинства возможных конфигураций сервера, от виртуальных хостингов до выделенных серверов. Для работы CS-Cart требуется два основных компонента:
PHP версии 5.6 или 7. CS-Cart поддерживает SAPI mod_php, FPM, FastCGI. Мы рекомендуем:
Рекомендуем не переходить на PHP 5.6, если вы использовали PHP 7.0 и более новые версии для своего магазина. Это может привести к тому, что пользователи не смогут войти в систему.
CS-Cart/Multi-Vendor 4.3.x – 4.8.x также поддерживают PHP 5.3.6 – 5.5, хотя мы их не рекомендуем. Поддержка PHP 7.2 впервые появилась в CS-Cart 4.7.2.
MySQL версии 4.1 или выше с поддержкой расширения MySQLi или pdo_mysql. Также поддерживаются MariaDB 5.5+ и PerconaServer 5.5+.
Рекомендуем использовать на сервере Unix-подобную операционную систему (например, FreeBSD, Linux или OS X). Эти системы хорошо масштабируются и обеспечивают высокий уровень безопасности и производительности. Поддерживаются и 64-битные, и 32-битные системы, но рекомендуем мы 64-битные: помимо ряда других преимуществ, они не ограничивают максимальный размер оперативной памяти 4 гигабайтами.
CS-Cart совместим почти с любым сервером, который поддерживает PHP и MySQL. Однако для стабильной работы магазина мы рекомендуем использовать Apache или Nginx в качестве веб-сервера.
Требования к настройкам сервера¶
Для Linux: отключены SELinux и AppArmor.
Отключена директива PHP safe_mode.
Включены директивы PHP file_uploads и allow_url_fopen.
Для PHP 5.3: отключены директивы PHP magic_quotes_gpc, magic_quotes_runtime, magic_quotes_sybase (если вы используете PHP 5.4 и выше, не обращайте внимание на это требование).
На сервере разрешено использовать:
| ini_set | ftp_exec | ftp_connect | ftp_login | ftp_get |
| ftp_put | ftp_nb_fput | ftp_raw | ftp_rawlist | mysql_pconnect |
| eva | system | exec | shell_exec | passthru |
| escapeshellarg | escapeshellcmd | set_time_limit |
Установлен модуль Imagick или GD; они нужны для работы с изображениями: создания иконок, добавления водяных знаков, и т.д. GD доступнее и есть на всех хостингах. Но мы рекомендуем Imagick, так как производительность и качество изображений после обработки у Imagick лучше.
Imagick — это модуль PECL. В официальной документации PHP есть инструкция по установке Imagick. На сервере должны быть установлены ImageMagick версии 6.5.3-10 или выше, а также PHP версии 5.4.0 или выше.
Настоятельно рекомендуем использовать версию ImageMagick 6.9.3-10 или выше; она содержит исправление критической уязвимости. ImageMagick 7 поддерживается начиная с CS-Cart 4.7.2.
Установлено расширение exif; начиная с версии 4.6.3, это расширение будет использоваться для того, чтобы иконки, сгенерированные из изображений, снятых в портретном режиме, были повёрнуты правильно.
Установлен модуль cURL; он нужен для поддержки безопасного соединения, а также для работы некоторых автоматических способов оплаты и доставки.
Включено расширение mbstring; оно необходимо для корректной работы с многобайтными строками (например, со строками, которые содержат кириллицу). Без этого расширения могут неправильно работать некоторые модули и функции ядра CS-Cart.
Включен модуль Phar (встроен в PHP, начиная с версии 5.3.0).
Включен модуль ZipArchive (встроен в PHP, начиная с версии v5.2.0).
При использовании веб-сервера Apache:
включен mod_rewrite (для работы SEO);
включен mod_headers (для работы CORS и режима виджета);
включен mod_ssl (для работы SSL);
выключен mod_security; если не хотите его полностью отключать, настройте его так, как указано в этом файле ;
в файле .htaccess разрешены следующие директивы:
| DirectoryIndex | Deny | Allow | Options | Order |
| AddHandler | RewriteEngine | RewriteBase | RewriteCond | RewriteRule |
Если PHP собран с расширением Suhosin, то настройте его в файле php.ini следующим образом:
Suhosin — это расширение PHP, предназначенное для защиты сервера. Однако, использование Suhosin может привести к различным проблемам в CS-Cart.
Рекомендации от команды CS-Cart¶
Список совместимых хостингов¶
Требования, приведенные выше, довольно типичные. Многие хостинговые компании смогут предложить вам подходящий вариант. Если у вас возникли сложности с выбором, можете обратиться к нашему списку совместимых хостингов (на английском языке).
Требования к аппаратному обеспечению сервера¶
Требования к аппаратному обеспечению не постоянные, а зависят от многих факторов. Чем больше количество пользователей, товаров и возможностей интернет-магазина, тем более производительный сервер вам потребуется.
Ниже дан пример сервера, которого будет достаточно для 50 посетителей в час:
Часто задаваемые вопросы¶
Общие вопросы¶
Что такое CS-Cart?¶
CS-Cart – это готовое решение для интернет-торговли, оно включает в себя все возможности, необходимые для построения успешного и конкурентоспособного онлайн-бизнеса.
Разработанный с использованием технологии открытого исходного кода, PHP/MySQL, Smarty, магазин CS-Cart является гибкой системой, которую можно легко настроить под потребности конкретного бизнеса. Функционал программы может быть без проблем расширен в соответствии с Вашими требованиями и нуждами. Платформа CS-Cart устанавливается только на Ваш веб-сайт (центральный сервер), его панель администратора и витрина управляются через браузер, позволяя зайти в магазин отовсюду, где есть интернет-соединение.
Чтобы узнать больше о платформе CS-Cart, Вы можете посмотреть список ее основных характеристик, прочитать полную документацию или просто протестировать онлайн демо-магазин и увидеть, как можно легко начать свой бизнес с CS-Cart.
На каких операционных системах работает CS-Cart?¶
Хотя CS-Cart работает на Windows и системах семейства Unix одинаково хорошо, мы бы порекомендовали устанавливать CS-Cart на такие системы, как Linux или FreeBSD, так как в них улучшена система безопасности и управления правами доступа.
В каких браузерах работает CS-Cart?¶
CS-Cart работает со всеми наиболее популярными браузерами, включая FireFox, Internet Explorer, Netscape, Opera и Safari.
Можно ли использовать CS-Cart на уже существующем сайте или необходимо создать новый?¶
CS-Cart можно использовать и как отдельный магазин, и как часть уже существующего сайта, в обоих случаях CS-Cart будет работать превосходно.
Вы также можете изменять дизайн магазина CS-Cart на свое усмотрение, чтобы он совпадал с дизайном основного сайта.
Как часто выпускаются обновления?¶
Новые версии CS-Cart с обновленными модулями, темами и т.д. выпускаются 2-3 раза в год. О новых релизах мы сообщаем в нашем блоге.
Могу ли я сам вносить изменения в полную версию CS-Cart?¶
В CS-Cart 100% открытый доступ к коду, поэтому его легко изменять. Вы можете вносить любые изменения в исходный код и расширять стандартную функциональность. Но помните, что ответственность за возможные последствия будет лежать на Вас. Если возникнут проблемы, наша техподдержка не сможет Вам помочь, потому что в их обязанности не входит анализ изменений, внесенных пользователями CS-Cart или сторонними разработчиками.
Также наши партнеры-разработчики с радостью помогут изменить Ваш магазин на платной основе в соответствии с Вашими требованиями и нуждами.
Работает ли CS-Cart с ЮKassa или PayPal?¶
Можно ли в CS-Cart рассчитать стоимость доставки в режиме реального времени?¶
Да. Доставка осуществляется с помощью самых надежных экспедиционных компаний в России и мире, таких как СПСР, СДЭК, EMS Russian Post, Почта России, FedEx, USPS, DHL и др. Методы доставки с настройкой стоимости вручную также доступны в CS-Cart. Используя настройки нашего ПО, Вы сможете контролировать точность расчета стоимости доставки.
Больше информации на странице «Способы доставки»
Безопасность¶
Можно ли защитить данные о заказах и другую конфиденциальную информацию от просмотра персоналом?¶
Да, в CS-Cart существует многоуровневая система доступа к панели администратора, которую можно настроить для каждого администратора Вашей компании. Можно задать настройки доступа к информации для каждого сотрудника в отдельности.
Есть ли в CS-Cart поддержка SSL?¶
Достаточно ли защищён СS-Cart?¶
Да. Мы считаем, что безопасность — одна из ключевых составляющих надежного интернет-магазина. Здесь Вы можете узнать больше о том, как повысить безопасность Вашего CS-Cart.
Функциональность¶
Оптимизирован ли CS-Cart для поисковых систем?¶
Да, платформа CS-Cart полностью оптимизирована для поисковых роботов и разработана таким образом, чтобы выводиться в верхних строках результатов основных поисковиков. Модуль SEO, который позволяет автоматически создать динамические URL из статических, интегрирован в CS-Cart. Включенный модуль может поднять Ваш вебсайт в рейтинге поисковых систем. Мы также рекомендуем добавлять мета-теги и ключевые слова на все страницы Вашего магазина.
Можно ли продавать цифровые товары в CS-Cart?¶
Поддерживает ли CS-Cart мультиязычность?¶
Да, поддерживает. Стандартный дистрибутив CS-Cart включает 20 языков: русский, английский, испанский, французский, греческий, итальянский, немецкий и др. (некоторые переводы даны только частично). Можно выбрать необходимый язык при установке магазина.
Также контент любых страниц в CS-Cart как на витрине, так и в панели администратора можно легко перевести на любой язык. Есть возможность самостоятельно добавить новый язык в панели администратора CS-Cart. Вы можете узнать больше о функциях перевода в CS-Cart из этого видео-урока.
Есть ли возможность закрывать магазин от пользователей время от времени?¶
Да. В панели администратора есть функция закрытия магазина. Он временно не будет доступен пользователям, но Вы сможете работать в нем в любое время.
Есть ли в CS-Cart возможность массово добавлять товары?¶
Да. Функция импорта в CS-Cart позволяет загрузить целиком базу данных товаров в формате CSV. Файлы этого формата можно редактировать в OpenOffice, LibreOffice или Excel. Вы также можете использовать данную функцию для импорта баз данных пользователей, заказов и переводов.
Почему при открытии CSV файла в Excel текст отображается в виде иероглифов?¶
Скорее всего возникла проблема с кодировкой файла. Для корректного отображения нужно использовать кодировку UTF-8. Изменить кодировку файла для просмотра в Excel можно в программе NotePad++.
Можно ли добавить параметры (например, цвет) для каждого отдельного товара?¶
Как изменить название и описание домашней страницы?¶
Для этого нужно пройти в меню «Дизайн → Макеты» и нажать на знак шестерёнки во вкладке «Домашняя страница». В открывшемся окне Вы сможете внести нужные изменения.
Можно ли использовать «Мой склад» вместо 1С «Управление торговлей»?¶
Есть ли в CS-Cart функция поставки?¶
Да. Данная функция доступна в стандартной версии CS-Cart. Она позволяет поставщикам показывать товар в магазине, а не держать на складе. После оформления заказа система сообщает поставщику об оформленном заказе и способе доставки. В таких случаях поставщик доставляет товар покупателю и стоимость доставки рассчитывается в зависимости от адреса покупателя. Ваша прибыль составляет разницу между оптовой ценой и розничной.
Ведет ли CS-Cart статистику?¶
Платформа CS-Cart собирает различного рода данные о посещаемости магазина. Анализ этой информации позволяет администраторам магазина делать необходимые улучшения и увеличивать производительность магазина.
Существуют ли ограничения на количество товаров в магазине?¶
Нет. В CS-Cart Вы можете добавлять неограниченное количество товаров и категорий. Благодаря использованию баз данных MySQL и других современных технологий, в платформе CS-Cart нет подобных ограничений.
Изменение дизайна¶
Можно ли заменить логотип CS-Cart на свой собственный?¶
Да. Чтобы поменять стандартный логотип CS-Cart на свой, откройте «Редактор дизайна» на странице «Дизайн → Темы» в панели администратора. В панели редактора дизайна выберите пункт «Логотипы». В CS-Cart также есть возможность сменить логотип для подарочных сертификатов, счетов и писем.
Эту ссылку могут изменить или удалить только владельцы лицензий CS-Cart. В пробной версиях она должна быть сохранена.
Пробная версия¶
Как установить пробную версию CS-Cart?¶
Куда вводить лицензионный ключ при покупке полной версии CS-Cart, чтобы обновить пробную версию до полной?¶
Покупка и поддержка¶
Хочу приобрести полную версию CS-Cart. Сколько времени на это потребуется?¶
Обработка заказа обычно занимает несколько часов, но не более одного рабочего дня.
Если я хочу открыть 2 магазина, мне нужно покупать 2 лицензии CS-Cart?¶
Нет, будет достаточно приобрести одну лицензию CS-Cart и одну лицензию на дополнительную витрину. Все витрины будут управляться из одной панели администратора. Вы сможете сделать базу товаров и покупателей общей для всех магазинов, либо различной, настроить общие или уникальные способы оплаты и доставки.
Могу ли я купить лицензию, если еще не знаю, для какого сайта она будет использоваться?¶
Конечно. Вы можете приобрести лицензию CS-Cart даже если Вы еще не знаете будущее доменное имя своего магазина. Введите «localhost» в поле «URL для лицензии» при оформлении заказа, и Вы сможете установить ПО на локальный компьютер или сеть. После установки CS-Cart на хостинг и домен, система автоматически привяжет Ваш лицензионный ключ к доменному имени.
Можно ли изменить доменное имя после покупки лицензии?¶
Да. Система автоматически сменит привязку Вашего лицензионного ключа к домену.
Могу ли я установить тестовую копию магазина?¶
Каждая лицензия CS-Cart позволяет устанавливать дополнительную копию программы для тестирования и разработки. Такая копия должна быть недоступна пользователям, поэтому стоит либо установить ее на локальном компьютере, либо задать пароль для доступа.
Ваша платежная система не принимает мою кредитную карту. Есть ли другие способы купить CS-Cart?¶
Пожалуйста, напишите нам, и наши специалисты предложат Вам альтернативные способы оплатить нашего ПО или услуги.
Что такое кредиты технической поддержки и что делать если они закончились?¶
Cs cart версия php
Before you start working, read PHP The Right Way.
The Boy Scouts have a rule: “Always leave the campground cleaner than you found it.” If you find a mess on the ground, you clean it up regardless of who might have made the mess. (by Uncle Bob at O’Reilly Commons)
Please rewrite the code that doesn’t follow the rules and standards outlined here, even if the code isn’t yours.
Standards¶
General Style¶
Names of Variables, Array Keys and Class Properties¶
Right:
Wrong:
Right:
Wrong:
Right:
Wrong:
Naming and Declaring Constants¶
Right:
Wrong:
String Literals¶
Magic Numbers in the Middle of the Code¶
Wrong:
Commenting¶
PHPDoc¶
Performance¶
Try to avoid using the Registry::get() summon in the body of the cycle. This operation requires a lot of resources, and addressing the storage lowers the performance significantly. To avoid cyclic calling, assign the value from Registry to the variable before the cycle, and use the variable within the cycle.
Code Smells¶
Code smells are symptoms of bad code architecture; they often cause problems with support, extendability, and testability of the code.
Nesting and Indentation¶
One of the worst code smells are multiple levels of nesting (and multiple levels of indentation as a result). Another example of this problem is when the entire code of the function is a part of a condition. It harms code readability and is a sign of bad code architecture.
Avoid these situations by changing the code structure: make all the necessary checks at the beginning of the function, have multiple exit points, or decompose the function into smaller functions.
Follow a simple rule: if a function has more than 3 levels of indentation, you probably should decompose your code or change the code’s structure.
Here are 2 examples:
Data Types¶
PHP is a weakly and dynamically typed language: any declared variable can contain any type of data. While this provides opportunities, it also allows for more mistakes, which can result in unexpected problems during code execution.
When working with variables, it’s a good idea to have a strict system of data types in mind. You must understand which data type can be stored in a variable, and structure your code according to this type casting. That way you won’t compare strings with integers, and arrays with zeros.
The descriptions of accepted and returned data types in PHPDoc help with type casting when you develop a function or a method. That way you can set the value of a variable to the expected type in the body of the function and be sure what data type you are dealing with.
This will allow you to use the === strict comparison operator, saving time for you and your colleagues in the future.
The code written for PHP 7 must use strict types for the returned values and arguments of functions.
Default Empty Value¶
If you use 0 or empty string as a default empty value, it may lead to errors with business-related logic. Your code might treat an actual 0 or an empty string as the default empty value. Using the empty function in conditions and checks often contributes to those errors.
Use null and the === strict comparison operator as often as possible.
Inverted Conditions¶
Example: Getting Rid of Code Smells¶
Here’s the example of code with multiple code smells at once:
Here’s how this code can be rewritten:
Functions¶
Names¶
Arguments¶
Here’s the example of how you can change the code:
The code that appears in two or more places in a controller or a function, it must be made a separate function.
Returning the Value is Good¶
Unless you work with a hook processor function, try not to pass variables to the function by reference, modifying the value of the variable without the function returning anything. This can lead to unaccountable and non-evident changes to the values of variables. Save your own time and the time of your colleagues that you’d otherwise spend on debugging.
Passing variables by reference doesn’t reduce memory consumption: PHP optimizes everything even if you pass variables by value.
Exit Point¶
A function should have only one exit point. Two or more exit points are acceptable in the following cases:
Comments on Deleted Functions¶
This comment is added to deprecated functions. The content of such functions is replaced by a notification:
Comments on Frequently Used Parameters¶
These are approved comments to describe variables in the code. Use these comments when defining a hook where it seems appropriate:
Object-Oriented Programming¶
Entity Names¶
Right:
Wrong:
Constants¶
The naming rules are the same as for constants outside of classes. Here’s an example:
Properties¶
Methods¶
Namespaces¶
Tygh is the name of the namespace that contains all the namespaces and core classes of CS-Cart.
This rule has 2 exceptions:
Design Patterns¶
You shouldn’t create singleton classes and the classes consisting of static methods. It is next to impossible to write unit tests for that kind of code.
SQL Queries¶
The proper placement of quotation marks and dots does matter.
PostgreSQL Compatibility¶
In addition to MySQL, CS-Cart 5 will support PostgreSQL. That’s why query structure must conform to the general SQL standard.
Don’t use proprietary features of MySQL or PostgreSQL.
Don’t use backticks ( ` ). Surround field names with double quotation marks. Quotation marks can be skipped; they are required for names that include reserved SQL keywords.
Don’t use REPLACE INTO in queries. Use function db_replace_into or Tygh::$app[‘db’]->replaceInto instead, depending on the context.
Always declare aliases in queries via the AS keyword.
Use single quotes ( ‘ ) to surround values. Don’t use double quotes for that purpose.
Don’t use aliases in the HAVING clause; use field names directly.
Don’t use raw SQL in migrations to change table structure; use only phinx commands.
Don’t use JOIN with DELETE statement.
General Rules¶
Using Exceptions¶
To aid with debugging fatal errors that prevent further execution of the program, CS-Cart has exceptions.
When Do I Throw an Exception?¶
You throw an exception when something goes wrong and prevents the program from further execution. For example, you do this when a class wasn’t found, or an undeclared hook was called.
How Do I Throw an Exception?¶
An exception is summoned like this:
The name of the class is the error type. The first parameter is the message that we want to display:
Information for Debugging¶
The debugging information appears in one of the following cases:
In other cases the store_closed.html page will appear, and error 503 will be returned if possible. The debugging information will appear in the code of the page, at the very bottom of the HTML commentary. This is done to prevent random customers from seeing technical information.
PHPUnit¶
This guide is relevant only if you have access to the CS-Cart repository.