如何将 Procedural 项目移植到 OO 项目中

Question

我有一个小型 PHP 项目（大约 3000 行），我需要为其创建一个基本的 UML 模型，从使用图、序列图和状态图的案例开始，可能还有类图，也许还可以用协作图来扩展它。

我是 UML 建模的新手，这是我第一次从实现中创建模型，而不是相反（不是很有用，除非您进行逆向工程，但无论如何，这是一项任务）

现在，我应该如何做解决这个问题？如果我的项目有 OO 实现，一些 UML 工具可以让我的生活变得非常轻松，但事实并非如此，所以我想知道我是否应该将我的项目重写为 OO 以及如何做到这一点（我的意思是，是否有一些标准的基本我应该遵循的准则或程序？），或者我是否应该按原样制作项目模型（在这种情况下哪种建模工具是最好的）。

另外，我的项目是在 Eclipse IDE 上编写的，有人知道有什么插件可以帮助我完成这个 UML 建模任务吗？

Answer 1

停止

您以前从事过面向对象编程吗？

您使用过 OO 建模技术吗？

您的 PHP 文件是否使用命名空间或函数前缀 ("("mylib.php", "function mylib_dosomething() { ... }")") ？

不要跳到UML，太快了。 UML就是做一个文档，
你脑子里有什么。

你必须首先思考，你要对网站做什么，
然后，记录并建模您的新网站将如何运作。

UML 是一个很棒的工具，但是，如果你头脑中的设计一团糟，
那么，你的文档就会变得一团糟。

您有一个正在运行的网站，并且想要替换它。
主要有两种方法。

(1) 从头开始​​：

如果您有 OO 经验，并且您可以忘记您的旧网站，让它继续运行，
并使用面向对象或一些现有的框架从“头”开始创建一个新网站。

(2) 重构

或者，您想维护当前的网站，并迁移到 OO，
步步。 ？它也被称为“重构”。

你可能一开始会认为你的主程序或主php文件是一个大对象（程序）文件，每个库文件也是对象。

示例：

假设您有几个 php 文件。有些文件是页面的主文件。有些文件包含在页面文件中甚至重复出现。其他的是仅具有功能的“库”文件。

---

<?php
// "indexfuncs1.php"

// this is an auxiliary file for "index.php",
// and has some free procedural code.

echo "indexfuncs1.php: dosomething()";

?>

---

<?php
// "funcslib.php"

// this is an library file,
// and has only functions and constants,

define ("ANYCONST", "Hello World");

function HelloWorld()
{
  echo ANYCONST;
}

?>

---

<?php
// "index.php"

// only declarations, doesn't do anything, by itself
//include("funcslib.php");
//require("funcslib.php");
//require_once("funcslib.php");
include_once("funcslib.php");

// this code is in other file, and its executed
include("indexfuncs1.php");

echo "index.php: Hello World";
HelloWorld();

// this code is in other file, and its executed
include("indexfuncs1.php");

?>

并开始将它们变成这样：

<?php
// "indexfuncs1.php"

// this is an auxiliary file for "index.php",
// and has some free procedural code.

function indexfuncs1_dosomething()
{
  echo "indexfuncs1.php: dosomething()";
}

?>

---

<?php
// "funcslib.php"

// this is an library file,
// and has only functions and constants,

define ("funcslib_ANYCONST", "Hello World");

function funcslib_HelloWorld()
{
  echo funcslib_ANYCONST;
}

?>

---

<?php
// "index.php"

// only declarations, doesn't do anything, by itself
//include("funcslib.php");
//require("funcslib.php");
//require_once("funcslib.php");
include_once("funcslib.php");

function index_main()
{
  // this code is in other file, and its executed
  indexfuncs1_dosomething();

  echo "index.php: Hello World";

  funcslib_HelloWorld();

  // this code is in other file, and its executed
  indexfuncs1_dosomething();    
}

?>

目前还没有面向对象。因为，这是一个中间步骤。

Lets start by transform each web page into a single class, without inheritance, without parent classes.

<?php
// "indexfuncs1.php"

// this is an auxiliary file for "index.php",
// and the free procedural code have become a class.

class indexfuncs1 {
    function dosomething()
    {
        echo "indexfuncs1.php: dosomething()";      
    } // function dosomething()
} // class IndexPage    

?>


<?php
// "index.php"

// only declarations, doesn't do anything, by itself
//include("funcslib.php");
//require("funcslib.php");
//require_once("funcslib.php");
include_once("funcslib.php");

class IndexPage {
    function main()
    {
      $myAux = new indexfuncs1();

      // this code is in other file, and its executed
      $myAux->dosomething();

      echo "index.php: Hello World";

      funcslib_HelloWorld();

      // this code is in other file, and its executed
      $myAux->dosomething();
    } // function main()
} // class IndexPage

function index_main()
{
    $myPage = new IndexPage();
    $myPage->main();
} // function index_main(...)

// --> the only allowed global procedural code:
index_main();

?>

（更多内容即将推出）。

Answer 2

要在 Eclipse 中建模 UML，您可能需要查看 Eclipse 建模工具 (MDT) 。