1

翻译模块

介绍

到目前为止,我的代码正在运行,但我不知道这是否是实现我想要的正确方法。我有一个小功能可以翻译网页上的字符串。如果我用数字调用它,它会在一个表中搜索 id,并且仅在它用于该页面时才显示它。如果我用字符串调用它,它会在另一个表中搜索该字符串,如果该字符串不存在,该函数会打印传递的字符串,用空格替换“_”并发出警告。

我想知道两件事是否正确实施(如上所述,它们有效,但我不确定它们是否是个好主意)。但首先是代码。

编码

// Function to output language strings.
function text($Id)
    {
    // Already defined and tested that are valid (sql injection avoided also)
    global $Lang;
    global $FullUrl;

    if (is_int($Id))    // If a number is being passed
        {
        $results = mysql_query("SELECT * FROM translations WHERE id='$Id' AND page='$FullUrl'") or die ('Could not query:' . mysql_error());
        $row = mysql_fetch_assoc($results);
        if (!empty($row[$Lang])) echo $row[$Lang];  // If there is some, echo it
        else error($FullUrl,$Lang); // Else, calls error function
        }

    else    // If a string is being passed
        {
        $results = mysql_query("SELECT * FROM htranslations WHERE keyword='$Id'") or die ('Could not query:' . mysql_error());
        $row = mysql_fetch_assoc($results);
        if (!empty($row[$Lang])) echo $row[$Lang];  // If it exists in the table, echo it
        else    // Else (it doesn't exist)
            {
            $NewId = str_replace("_", " ", $Id);    // Replace the "_" with " "
            echo "<span style='color: red;' title='";   // Set a red color (warning)
            text(Wrong_sentence);   // Call this function and echo "This sentence could be wrong"
            echo "'>".$NewId."</span>"; // Echo the passed string with spaces
            error($FullUrl,$Lang,$Id);
            }
        }
    }

1、在函数内回显好还是在函数外回显好?

我已经阅读了这个问题,并且我不打算进一步操纵字符串。所以,从那篇文章中,我猜最好的主意是像我已经做过的那样做,在函数内部呼应,但我想知道你对这个特殊情况的看法,因为我仍然不确定。返回值并回显该值或从函数回显它会更好吗?为什么?我的问题集中在性能和使代码友好上。

2. 从函数内部调用这个函数有危险吗?

如您所见,在我写的最后一行中text(Wrong_sentence);。我知道你可以从另一个函数调用一个函数,但是你能从同一个函数调用一个函数吗?我担心它会进入调用自身的无限循环,例如,如果 table 关键字Wrong_sentence被删除或修改。此外,我不知道可能存在其他安全后果。

欢迎对代码提供任何其他类型的反馈!

4

2 回答 2

3

关注点分离是首先要处理的部分。那只是必不可少的。

通常,您所做的是对此有意义的全局函数。它至少应该在视图中可用。虽然我有些担心:

  1. Globals:您使用全局变量,只是不喜欢那样。更糟糕的是,你甚至不检查里面有什么。如果您最终开始使用它们,请确保在使用它们之前检查它们。例如,它可能被覆盖或任何会产生模糊错误的东西。

  2. 关注点分离:这个函数应该只是向模型询问文本。就是这样。该模型可能返回 false/void/error 或仅返回文本。处理

  3. 此函数的位置:通常,这在 MVC 术语中称为 Helper,因此查看 Helpers 可能会很有趣。例如在 CakePHP 中是这样的: http: //book.cakephp.org/2.0/en/views/helpers.html这样你就可以更标准的方式来设计它,你也可以使用标准,这样就可以很容易地找到其他的开发商。如果我看到一个我知道在哪里寻找它的助手,则可以在系统的任何位置定义一个全局函数。

  4. 从不回声:回声不是很好,我们更喜欢仅在需要时将它们直接放入视图中。为什么?因为它使调试结果更容易,我们只需要一种方法,但在变量和回显中使用它们。

    回显文本(123);

它不需要更多的代码或其他东西,但它会生成一个标准。例如,如果您在变量或其他方法中需要它:

echo strtotupper(text(123));

如果您正在测试您需要相同的内容,则需要该函数的响应。显然,可以测试回声,但返回效果更好。

  1. URL和文本的组合:一段文本属于其他内容。该 URL 链接到该内容,但似乎不是正确的链接。例如,获取一个标题在 URL 中有错字的页面。URL 得到修复,但您的文本不再链接。

  2. 在一个功能中结合 2 个功能:当您开始单元测试代码时,您会注意到为什么这会产生更多的复杂性问题。您有 2 个函数,getTextById 和 getTextByKeyword。基本上你已经在这里看到了这个问题:

    “SELECT * FROM htranslations WHERE 关键字='$Id'”

您正在查找似乎是关键字的 $Id。容易出错的代码。选择一种口味并坚持下去。一般来说,我不喜欢硬编码的 id,因为他们什么都不说。所以我建议使用类似的东西:

text('CONTACT_ADDRESS')

那种标签是可读的(这在视图中很重要并且很有意义。例如一个坏的:

<p><?php text(24234); ?></p>
<p><?php text(96985); ?></p>

你不知道它是什么。但是,如果我在视图中写了这个,那就很清楚了:

<p><?php text('ORGANISATION_INTRODUCTION'); ?></p>
<p><?php text('ORGANISATION_FOUNDERS'); ?></p>

这些是 2 段文本,但现在你知道是哪段了。如果您看到页面本身,您也知道在哪里可以找到它们。如您所见,这些简单示例使用页面前缀,但显然也可能存在全局文本。就像侧边栏中的文本。根据您的需要,这里有很多选择。您甚至可以自动添加页面名称等。

  1. 滥用 MySQL 函数:不要再这样做了:

    $results = mysql_query("SELECT * FROM htranslations WHERE keyword='$Id'") or die ('Could not query:' .mysql_error());

只需创建一些 PDO 语句或其他安全的东西,并确保您捕获错误、验证输入等。由于此类问题,已经看到了很多黑客攻击。

  1. 已有的解决方案:您不是第一个翻译文本的人。那么您为什么不看一下已经可用的系统,例如支持多语言的 Framework 或http://www.gnu.org/software/gettext/。已经有这么多花样了,为什么还要开发一个新的呢?

  2. 递归:如果您当前使用错误的键调用您自己的函数,因为未找到错误,它将一次又一次地调用。只是不太好。将您的错误处理(这是一个开发错误)拆分为一个单独的类。这可以处理它自己的错误处理。这也是关注点分离。

显然,您可以添加更多反馈,但认为这可以让您完全开始重新思考您的方法。不仅有一个好的解决方案,而且可以肯定的是,您可以在第一个概念上进行很多改进。

于 2012-04-11T15:40:58.443 回答
0

由于从其他答案和评论中可以清楚地看到第二个问题,因此我将回答第一个问题(尽管我认为回答自己很奇怪,但我为我的问题找到了更合适的答案)。我可以两者兼得,同时在室内或室外回响。这是代码:

// Function to output language strings.
function text($Id)
    {
    // Already defined and tested that are valid (sql injection avoided also)
    global $Lang;
    global $FullUrl;

    $numargs = func_num_args(); // Get the number of arguments that are being passed.
    if ($numargs == 2)  // If there are actually two
        $Var=func_get_arg(1);   // Set $Var with the second value (1).

    if (is_int($Id))    // If a number is being passed
        {
        $results = mysql_query("SELECT * FROM translations WHERE id='$Id' AND page='$FullUrl'") or die ('Could not query:' . mysql_error());
        $row = mysql_fetch_assoc($results);
        if (!empty($row[$Lang]) && !isset($Var)) echo $row[$Lang];  // If there is some, echo it
    elseif ($Var==1) return $row[$Lang];
        else error($FullUrl,$Lang); // Else, calls error function
        }

    else    // If a string is being passed
        {
        $results = mysql_query("SELECT * FROM htranslations WHERE keyword='$Id'") or die ('Could not query:' . mysql_error());
        $row = mysql_fetch_assoc($results);
        if (!empty($row[$Lang]) && !isset($Var)) echo $row[$Lang];  // If it exists in the table, echo it
        elseif (!empty($row[$Lang]) && isset($Var)) return $row[$Lang];
        else    // Else (it doesn't exist)
            {
            $NewId = str_replace("_", " ", $Id);    // Replace the "_" with " "
            echo "<span style='color: red;' title='";   // Set a red color (warning)
            text(Wrong_sentence);   // Call this function and echo "This sentence could be wrong"
            echo "'>".$NewId."</span>"; // Echo the passed string with spaces
            error($FullUrl,$Lang,$Id);
            }
        }
    }

所以,如果我只想 ECHO 一些文本,我会写tex(56),text(Existing_string)text(Non_existing_string). 但是要将这些相同的文本作为变量返回,我只需要编写tex(56,1),text(Existing_string,1)"Non existing string". 请注意,要使用“非现有字符串”,我不需要传递它并返回自身。

该代码仍然存在许多问题,但正如您所见,我正在学习和改进它。到目前为止,这段代码工作得很好。

于 2012-04-12T18:05:56.020 回答