100

除了官方论坛上的一些 api 调用外，他们似乎没有任何文档。我有 Zend 框架和 CodeIgniter 框架的经验。任何 OpenCart 大师都可以推荐我在最短的时间内学习并掌握它的最佳方法吗？我必须尽快用它做一个大项目。

4

6 回答 6

316

面向初学者的 OpenCart 1.5.X 开发者快速入门指南

本指南是为已经熟悉 PHP、OOP 和 MVC 架构的开发人员编写的

在下文中，您将看到购物车目录侧的示例。除了相关部分中提到的视图外，管理端在功能上是相同的

了解图书馆

所有库功能都可以通过控制器、模型和视图使用$this->library_name. 所有这些都可以在/system/library/文件夹中找到。例如，要访问当前购物车的产品，您需要使用Cart该类，该类位于/system/library/cart.php并且可以使用$this->cart->getProducts()

常用物品

  • customer.php- 客户相关功能
  • user.php- 管理用户相关功能
  • cart.php- 购物车相关功能
  • config.php- 所有设置都从此加载
  • url.php- URL生成功能

了解路由参数

OpenCart 的框架依赖于route=aaa/bbb/ccc查询字符串中的参数来知道要加载什么，并且是查找需要为每个页面编辑的文件的基础功能。大多数路由实际上只使用aaa/bbb应该被视为两部分的，但是有些包含三个部分aaa/bbb/ccc第一部分aaa通常与通用文件夹中的文件夹相关，例如控制器或模板文件夹。第二部分通常与文件名有关，没有相关.php或.tpl扩展名。第三部分在下面的“了解控制器”部分进行了解释

理解语言

语言存储在子/catalog/language/文件夹中的your-language文件夹中。其中，跨页面使用的一般文本值存储在your-language.php文件夹内的文件中，因此对于目录端的英语，您可以在catalog/language/english/english.php. 对于特定的页面文本，您需要route页面的 （通常是这种情况，但并非总是如此，因为您可以指定任何您喜欢的语言文件）。例如，搜索页面有路由product/search，因此该页面的语言特定文本可以在catalog/language/english/product/search.php（注意文件名和子文件夹与.php.

要在控制器中加载语言，请使用

$this->language->load('product/search');

然后就可以使用语言库功能get来检索特定的语言文本，比如

$some_variable = $this->language->get('heading_title');

语言变量使用特殊变量在语言文件中分配，该变量$_是键和文本值的数组。在你的/catalog/language/english/product/search.php你应该找到类似的东西

$_['heading_title']     = 'Search';

全局语言文件english/english.php中的值会自动加载，并且可以在没有$this->language->load方法的情况下使用

了解控制器

控制器是基于 加载的，route并且很容易理解。控制器位于/catalog/controller/文件夹中。继续上一个示例，搜索页面的控制器/product/search.php位于此文件夹中。再次注意，使用了后面的路线.php。

打开控制器文件，您将看到一个扩展Controller类的 Pascal Case 类名，称为ControllerProductSearch. 这又是特定于路由的，Controller后跟子文件夹名称和文件名，扩展名不大写。大写实际上不是必需的，但为了便于阅读，建议使用它。值得注意的是，除了字母和数字之外，类名不会从子文件夹和文件名中获取任何值。下划线被删除。

类中有方法。声明的类中的方法public可以通过路由运行 -private不是。默认情况下，使用标准的两部分路由（aaa/bbb如上），index()会调用默认方法。如果使用了路由的第三部分（ccc上面），则将运行此方法。比如account/return/insert会加载/catalog/controller/account/return.php文件和类，并尝试调用insert方法

了解模型

OpenCart 中的模型位于/catalog/model/文件夹中，并根据功能而非路由进行分组，因此您需要通过以下方式将它们加载到控制器中

$this->load->model('xxx/yyy');

这会将文件加载到xxx名为yyy.php. 然后可以通过对象使用

$this->model_xxx_yyy

和控制器一样，你只能调用它的public方法。例如，要调整图像大小，您可以使用模型并按如下方式tool/image调用其方法resize

$this->load->model('tool/image');
$this->model_tool_image->resize('image.png', 300, 200);

从控制器了解视图中的变量分配

为了从控制器向视图传递值，您只需将数据分配给$this->data变量，该变量本质上是一个键 => 值对的数组。举个例子

$this->data['example_var'] = 123;

如果您熟悉将每个键转换为变量的extract()方法，在视图中访问它应该很容易理解。所以example_var密钥变成$example_var并且可以在视图中访问。

理解主题

主题仅在目录端可用，基本上是一个包含模板、样式表和主题图像的文件夹。主题文件夹放置在/catalog/view/theme/后跟主题名称的文件夹中。文件夹名称不重要，default文件夹除外

管理端使用/admin/view/template/（从路径中跳过，/theme/theme-name/因为它不允许不同的主题）

模板文件位于template主题文件夹内的文件夹中。如果当前选择的主题没有任何模板可用，则使用默认文件夹的模板作为备用。这意味着可以用很少的文件创建主题，并且仍然可以充分发挥作用。它还可以减少代码重复和升级时的问题

了解视图（模板）

与语言和模型一样，视图文件通常与路线相关，但根本不必如此。/catalog/view/theme/your-theme/template/除非它不存在，否则通常会在目录端找到模板，在这种情况下，将使用默认主题的模板。对于我们上面的搜索页面示例，文件是product/search.tpl. 对于三部分的路线，aaa/bbb_ccc.tpl虽然没有硬性规定，但通常是在其中。在 admin 中，大多数页面都遵循此规则，除了列出项目的页面（如产品列表页面）catalog/product_list.tpl和产品编辑表单位于catalog/product_form.tpl. 同样，这些不是设置的，而是默认购物车的标准。

模板文件实际上只是另一个 php 文件，但扩展名为 .tpl，并且实际上在控制器文件中运行，因此您可以在控制器中编写的所有内容都可以在模板文件中运行（尽管不推荐，除非绝对必要的）

了解数据库对象

查询运行使用

$result = $this->db->query("SELECT * FROM `" . DB_PREFIX . "table`");

DB_PREFIX顾名思义，是一个包含数据库前缀（如果存在）的常量

$result将返回一个用于SELECT查询的对象，其中包含一些属性

$result->row如果一个或多个作为关联数组返回，则包含第一行的数据

$result->rows包含一组行结果，非常适合使用 foreach 循环

$result->num_rows包含返回的结果数

$this->db该对象还有一些额外的方法

$this->db->escape()对传递的值使用mysql_real_escape_string()

$this->db->countAffected返回受UPDATE查询影响的行数等

$this->db->getLastId()使用mysql_insert_id()返回最后一个自动递增 id

了解保留变量

OpenCart 有预定义的变量来代替标准的$_GET, $_POST, $_SESSION, $_COOKIE, $_FILES, $_REQUESTAND$_SERVER

$_SESSION使用$this->session->datawhere data 是一个模仿$_SESSION

所有其他人都可以使用$this->request并已“清理”以符合启用/禁用的魔术引号，因此

$_GET变成$this->request->get

$_POST变成$this->request->post

$_COOKIE变成$this->request->cookie

$_FILES变成$this->request->files

$_REQUEST变成$this->request->request

$_SERVER变成$this->request->server

概括

虽然以上内容对于开发人员来说并不是一个万无一失的指南，但希望它可以为那些入门者提供一个很好的起点

于 2012-11-21T01:11:26.860 回答
37

全局库方法：基本的 opencart 库函数及其功能，其中大部分可以从目录或管理文件夹（控制器、模型、视图）中的任何位置调用

CACHE
$this->cache->delete($key) - Deletes cache [product, category, country, zone, language, currency,
manufacturer]

CART
$this->cart->getProducts() Gets all products currently in the cart including options, discounted prices, etc.
$this->cart->add( $product_id, $qty = 1, $options = array()) - Allows you to add a product to the cart
$this->cart->remove( $key ) - Allows you to remove a product from the cart
$this->cart->clear() - Allows you to remove all products from the cart
$this->cart->getWeight() - Sum of the weight of all products in the cart that have require shipping set to Yes
$this->cart->getSubTotal() - returns the subtotal of all products added together before tax
$this->cart->getTotal() - returns the total of all products added together after tax
$this->cart->countProducts() - returns the count of all product in the cart
$this->cart->hasProducts() - returns true if there is at least one item in the cart
$this->cart->hasStock() - returns false if there is at least one item in the cart that is out of stock
$this->cart->hasShipping() - returns true if there is at least one item in the cart that requires shipping
$this->cart->hasDownload() - returns true if there is at least one item in the cart that has a download
associated

CONFIG
$this->config->get($key) - returns setting value by keyname based on application (catalog or admin)
$this->config->set($key, $value) - set the value to override the setting value. DOES NOT SAVE TO DATABASE

CURRENCY
$this->currency->set($currency) - set or override the currency code to be used in the session
$this->currency->format($number, $currency = '', $value = '', $format = TRUE) - format the currency
$this->currency->convert($value, $from, $to) - convert a value from one currency to another. Currencies must
exist
$this->currency->getId() - get the database entry id for the current currency (1, 2, 3, 4)
$this->currency->getCode() - get the 3-letter iso code for the current currency (USD, EUR, GBP, AUD, etc)
$this->currency->getValue($currency) - get the current exchange rate from the database for the specified
currency.
$this->currency->has(currency) - Check if a currency exists in the opencart currency list

CUSTOMER
$this->customer->login($email, $password) - Log a customer in
$this->customer->logout() - Log a customer out
$this->customer->isLogged() - check if customer is logged in
$this->customer->getId() - get the database entry id for the current customer (integer)
$this->customer->getFirstName() - get customer first name
$this->customer->getLastName() - get customer last name
$this->customer->getEmail() - get customer email
$this->customer->getTelephone() - get customer telephone number
$this->customer->getFax() - get customer fax number
$this->customer->getNewsletter() - get customer newsletter status
$this->customer->getCustomerGroupId() - get customer group id
$this->customer->getAddressId() - get customer default address id (maps to the address database field)

DATABASE
$this->db->query($sql) - Execute the specified sql statement. Returns row data and rowcount.
$this->db->escape($value) - Escape/clean data before entering it into database
$this->db->countAffected($sql) - Returns count of affected rows from most recent query execution
$this->db->getLastId($sql) - Returns last auto-increment id from more recent query execution 4

DOCUMENT (*Called from controller only before renderer)
$this->document->setTitle($title) - Set page title
$this->document->getTitle()- Get page title
$this->document->setDescription($description) - Set meta description
$this->document->getDescription()- Get meta description
$this->document->setKeywords()- Set meta keywords
$this->document->getKeywords()- Get meta keywords
$this->document->setBase($base) - Set page base
$this->document->getBase() - Get page base
$this->document->setCharset($charset) - Set page charset
$this->document->getCharset() - Get page charset
$this->document->setLanguage($language) - Set page language
$this->document->getLanguage()- Get page language
$this->document->setDirection($direction) - Set page direction (rtl/ltr)
$this->document->getDirection()- Get page direction (rtl/ltr)
$this->document->addLink( $href, $rel ) – Add dynamic <link> tag
$this->document->getLinks()- Get page link tags
$this->document->addStyle( $href, $rel = 'stylesheet', $media = 'screen' ) – Add dynamic style
$this->document->getStyles()- Get page styles
$this->document->addScript( $script ) - Add dynamic script
$this->document->getScripts()- Get page scripts
$this->document->addBreadcrumb($text, $href, $separator = ' &gt; ') – Add breadcrumb
$this->document->getBreadcrumbs()- Get Breadcrumbs

ENCRYPT
$this->encryption->encrypt($value) - Encrypt data based on key in admin settings
$this->encryption->decrypt($value) - Decrypt data based on key in admin settings

IMAGE
$this->image->resize($width = 0, $height = 0)

JSON
$this->json->encode( $data )
$this->json->decode( $data , $assoc = FALSE)

LANGUAGE
$this->language->load($filename);

LENGTH
$this->length->convert($value, $from, $to) - convert a length to another. units must exist
$this->length->format($value, $unit, $decimal_point = '.', $thousand_point = ',') - format the length to use
unit

LOG
$this->log->write($message) - Writes to the system error log

REQUEST
$this->request->clean($data) - Cleans the data coming in to prevent XSS
$this->request->get['x'] - Same as $_GET['x']
$this->request->post['x'] - Same as $_POST['x']

RESPONSE
$this->response->addHeader($header) - additional php header tags can be defined here
$this->response->redirect($url) - redirects to the url specified

TAX
$this->tax->setZone($country_id, $zone_id) - Set the country and zone id for taxing (integer)
$this->tax->calculate($value, $tax_class_id, $calculate = TRUE) - Calculate all taxes to be added to the total
$this->tax->getRate($tax_class_id) - Get the rates of a tax class id
$this->tax->getDescription($tax_class_id) - Get the description of a tax class id
$this->tax->has($tax_class_id) - Check if a tax class id exists in opencart

SESSION
$this->session->data['x'] - Same as $_SESSION['x']
于 2013-10-10T09:33:29.127 回答
10

有一个 OpenCart Wiki 网站，其中包含面向初学者开发人员的文档。按照下面给出的网址了解更多详细信息：

http://wiki.opencarthelp.com/doku.php?id=start
http://wiki.opencarthelp.com/doku.php?id=methods_reference

互联网档案链接

http://web.archive.org/web/20160305131349/http://wiki.opencarthelp.com/doku.php?id=start http://web.archive.org/web/20160305131349/http://wiki .opencarthelp.com/doku.php?id=methods_reference

例如，方法参考有以下详细信息：

  1. 客户登录
  2. 数据库访问
  3. 购物车处理
  4. 配置
  5. 缓存
  6. 货币处理

仍然有一些页面正在建设中，但它会有所帮助。

[更新]

截至 2018 年 1 月，opencarhelp.com 域已关闭。

于 2014-05-30T05:56:33.767 回答
6

虽然这个话题已经回答了很多次，但我想根据我的经验提供另一种掌握 OpenCart 的方法。

边干边学

通过使用少量文件从头开始创建自己的 OpenCart 框架，您可以了解所有内容是如何组合在一起的。我将为您模仿 OpenCart 的文件结构。

创建文件index.php

<?php
// My simpleCart

1.注册表

Opencart 使用注册表模式列出加载类的所有实例。它是您的 OpenCart 应用程序的核心。然后将注册表对象传递给每个类别、模型和库，以便快速访问其他对象。

创建一个带路径的文件/system/engine/registry.php

<?php
// Registry class. 
class Registry
{
    private $data = array();

    public function set($key, $value){
        $this->data[$key] = $value;
    }

    public function get($key){
        return (isset($this->data[$key])) ? $this->data[$key] : false;
    }
}

在你的index.php

<?php
// My simpleCart

//load dependency files
require_once('system/engine/registry.php');

//initialize registry
$registry = new Registry;

2. 输出

现在让我们添加一个输出，它将成为我们未来的 HTML。毕竟，整个想法是向浏览器发送一串文本。

创建文件system/library/response.php

<?php
class Response {
    private $output;

    public function getOutput() {
        return $this->output;
    }

    public function setOutput($output) {
        $this->output = $output;
    }

    public function output() {
        if ($this->output) {
            echo $this->output;
        }
    }
}

在你的index.php 

<?php
// My simpleCart

//load dependency files
require_once('system/engine/registry.php');
require_once('system/library/response.php');

//initialize registry
$registry = new Registry;

//initialize response
$response = new Response;
//add response object to the registry
$registry->set('response', $response);

//lets set an output as a test
$registry->get('response')->setOutput('Hello World');

//send the output to the client
$registry->get('response')->output();

请注意，我添加 Hello world 仅作为示例。我们将进一步删除它。刷新您的网站以检查它。浏览器应显示Hello World.

3.控制器

将控制器视为页面。他们将定义向客户端显示的内容：文本、html、json、下载甚至图像。现在，我们只需要一个发送文本的页面。

我们将为home页面创建一个控制器。

添加带有路径的文件catalog/controller/common/home.php

<?php

class ControllerCommonHome{

    private $registry = array();

    public function __construct($registry){
        $this->registry = $registry;
    }

    public function index(){

        $output = 'Home Page';
        //using the registry to get the response object and set the Output
        $this->registry->get('response')->setOutput($output);
    }
}

并编辑您的index.php

<?php
// My simpleCart

//load registry
require_once('system/engine/registry.php');
//load response
require_once('system/library/response.php');

//initialize registry
$registry = new Registry;

//initialize response
$response = new Response;
//add resoinse object to the registry
$registry->set('response', $response);

//load controller common/home
require_once('catalog/controller/common/home.php');
$controller = new ControllerCommonHome($registry);
$controller->index();

//send the output to the client
$registry->get('response')->output();

请注意我如何将 传递$refistry给 ControllerCommonHome 以便我可以在控制器内部访问它。

4.路由器

我们不希望控制器被硬编码，对吧。我们将使用route来自 url 地址的参数来告诉我们的购物车要加载哪个控制器。

创建一个带路径的文件system/library/request.php

<?php
class Request {
    public $get = array();

    //for now I just need the $_GET parameter
    public function __construct() {
        $this->get = $_GET;
    }
}

创建Router类，该类将负责根据路由初始化Controller文件（换句话说：动态调用控制器）

<?php
class Router {
    private $registry;

    public function __construct($registry) {
        $this->registry = $registry;
    }

    public function dispatch($route) {
        require_once('catalog/controller/'.$route.'.php');
        $class = "Controller".str_replace('/', '', $route);
        $controller = new $class($this->registry);
        $controller->index();
    }
}

将其加载到您的index.php

<?php
require_once('system/engine/registry.php');
require_once('system/engine/router.php');
require_once('system/library/response.php');
require_once('system/library/request.php');

$registry = new Registry;

$response = new Response;
$registry->set('response', $response);

$request = new Request;
$registry->set('request', $request);

//get the route from the url
if(isset($registry->get('request')->get['route'])){
    $route = $registry->get('request')->get['route'];
}else{
    $route = 'common/home';
}

//initiate the router and dispatch it base on the route
$router = new Router($registry);
$router->dispatch($route);


$registry->get('response')->output();

请注意我如何将所有内容加载到 中$registry，然后将其传递给$routerwhich 然后将其传递给$controller.

这篇文章已经太长了，但我希望它能对 OpenCart 中的 MVC 模式有一个基本的了解。

如果你想让我继续这篇文章并告诉你其他东西是如何工作的，比如模型和视图，请评价这个答案，以便我知道。

另请查看我的 Youtube https://www.youtube.com/dreamvention和我的博客https://dreamvention.com/blog我将在那里为你们发布更多提示和教程！

于 2019-03-06T06:15:12.720 回答
1

PHP 是一种相当大的语言，具有超过 5000 个内置函数，因此学习新平台的一个策略是确定它最常使用的函数并花一些时间来很好地了解这些函数。

我在 OpenCart 源代码上运行了一些查询，前 10 个最常用的函数是：

array()
count()
explode()
implode()
mktime()
delete()
time()
date()
sprintf()
list()

此处列出的所有 52 个命令以及您可以在任何代码库上使用的 Linux bash 命令来识别常用功能： https ://www.antropy.co.uk/blog/efficient-learning-for-new-opencart-developers/

于 2017-11-20T10:18:42.603 回答
0

这个 youtube 视频播放列表也有助于成为 OpenCart 开发者大师：

OpenCart 视频教程

  1. 简介和目录本视频介绍了该系列
  2. OpenCart 安装 localhost本视频介绍了在 localhost 中安装 OpenCart
  3. OpenCart 的文件和文件夹结构它描述了 OpenCart 的文件和文件夹结构
  4. 在 OpenCart 中创建数据库表模式它显示了数据库表模式并展示了如何在 OpenCart 中创建数据库表
  5. OpenCart 库预定义对象的方法它描述了 OpenCart 库预定义对象的方法并显示了在哪里可以找到它们。

  6. OpenCart 中的 MVCL 模式、代码流和请求与响应它显示了 OpenCart 中的 MVCL 模式、代码流和请求与响应。他们描述了如下图所示的流程： 用代码描述的 MVCL

  7. 安装、配置和卸载 OpenCart 模块它显示了上传模块的三种方法，然后安装、配置和卸载 OpenCart 3 模块/扩展。

  8. Opencart 3中的布局和位置 它描述了 OpenCart 3 的布局和位置。它展示了如何显示不同页面的自定义布局，并给出了类别页面的示例。我们展示了不同类别的不同布局。

  9. Opencart 的事件概述您将了解 OpenCart 中的事件、它们的工作原理以及使它们如此有用的原因。

  10. 面向开发人员的 Opencart API 文档此视频将展示如何使用和制作自定义 opencart API

看到这些视频后，您就可以开始编码了 :)

于 2019-01-06T19:44:29.497 回答